Conductor Monitoring Reporting API - Conductor Documentation

Getting Started

Overview

Our Reporting API is used for extracting data and metrics from your Conductor Monitoring account. Typical use-cases include connecting several software solutions together to streamline your reporting tasks and integrating Conductor Monitoring in your client portal.

Important

This support article is covering the current 2.0 version of Conductor Monitoring’s Reporting API. We recommend using the Reporting API v2.0 for your reporting tasks and integrations as all new endpoints will be only supported on this version.The legacy Conductor Monitoring Reporting API version is still available. You can find the relevant support documentation and our migration guide in the Conductor Monitoring Reporting API V1.0 article.Please note that while the legacy Reporting API v1.0 remains available at the moment, it will likely be deprecated in the future. Therefore we highly recommend using (and migrating to) the Reporting API v2.0.Note!Conductor provides APIs for several different uses across its Conductor Monitoring and Conductor Intelligence products. This article describes Conductor Monitoring’s Reporting API. If you are looking for information about a different API offering, consider the following articles:

Reporting API Terms of Use

By using the Reporting API you agree to the Terms of Use.

Authentication

Get your API integration token

To use Conductor Monitoring’s Reporting API you need to get your account’s Reporting API token. You’ll find it in the Integration Tokens section under the Account tab in the main Account section.

Configure your request headers

To authenticate your requests, you need to include the following request headers:

Authorization: token {place-your-API-token-here}
Content-Type: application/json

Note!

The value for the Authorization header must be the string “token” followed by a space and then your actual API token.

Rate limits

The Reporting API uses rate limits to ensure API request traffic can be handled efficiently. Rate limits define the maximum number of requests which can be made in a given time range. Conductor Monitoring’s Reporting API has the following rate limits:

6 requests/second/requester IP address
When the limit is hit the API returns a 429 status code for 1 minute

Note that there is no maximum number of calls you can make to this API.

Using the Conductor Monitoring Reporting API

Base URL

Conductor Monitoring Reporting API is available on the following URL:

https://api.cm.conductor.com/

Retrieving a list of websites in your account

/v2/entities/websites

Request Body

None

Responses

200	Successful query execution Schema: See below Example { “data”: [ { “id”: “1-234”, “app_url”: “https://app.cm.conductor.com/websites/1-234/dashboard”, “domain”: “https://www.conductor.com”, “name”: “null”, “page_capacity”: 1000 }, { “id”: “1-2345”, “app_url”: “https://app.cm.conductor.com/websites/1-2345/dashboard”, “domain”: “https://www.conductor.de”, “name”: “Conductor Monitoring - DE”, “page_capacity”: 1000 }, ] }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`id`	string
`app_url`	string (absolute URL)
`domain`	string (absolute URL)
`name`	string
`page_capacity`	integer

Retrieving a list of segments for a website

/v2/entities/segments?website_id={website_id}

Send this request—using a website ID—to get a list of segments for a specific website in your account.

Request Path Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

Request Response

200	Successful query execution Schema: See below Example { “data”: [ { “id”: “1”, “color”: “bf86d5”, “label”: “Important pages”, “shortcode”: null }, { “id”: “2”, “color”: “72c035”, “label”: “Indexable”, “shortcode”: null }, ] }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`id`	string
`color`	string
`label`	string
`shortcode`	string

Retrieving statistics for a website or website’s segment

/v2/data/statistics?website_id={website_id}

Use this endpoint to pull data for one of your tracked websites or for a part of a tracked website.

Request Path Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

Query Parameters

scope (Required). Determines whether data for the whole website is returned or specific parts. Potential values:

website. Retrieves data for the whole website.
segment:{segment_id}. Retrieves data for a specific segment. Segment IDs can be inferred with the GET /v2/entities/segments endpoint described above.
segment_label:{segment_label}. Retrieves data for a specific segment. Segment label can be inferred from the GET /v2/entities/segments endpoint described above.

Request Responses

200	Successful query execution Schema: See below Example { “data”: { “health”: 916, “number_of_issues”: 1234, “number_of_urls”: { “missing”: 0, “page”: 123, “redirect”: 0, “server_error”: 0, “unreachable”: 0 }, “number_of_urls_per_property”: { “h1”: { “available”: 123, “empty”: 0, “missing”: 0 }, “health”: { “0-100”: 0, “100-200”: 0, “200-300”: 0, “300-400”: 0, “400-500”: 0, “500-600”: 0, “600-700”: 0, “700-800”: 0, “800-900”: 0, “900-1000”: 1234 }, “hreflang_language”: { “en”: 1234, “missing”: 0, “others”: 0 }, “is_disallowed_in_robots_txt”: { “true”: 0, “false”: 1234 }, “is_in_sitemap”: { “true”: 1234, “false”: 0 }, “is_indexable”: { “true”: 1234, “false”: 0 }, “is_indexable_due_to_meta_robots”: { “no”: 0, “not_applicable”: 0, “yes”: 1234 }, “is_indexable_due_to_x_robots_tag”: { “no”: 0, “not_applicable”: 0, “yes”: 1234 }, “is_linked”: { “true”: 1234, “false”: 0 }, “meta_description”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “open_graph_description”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “open_graph_image”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “open_graph_title”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “open_graph_type”: { “empty”: 0, “missing”: 0, “others”: 0, “values”: { “article”: 1230, “website”: 2, “object”: 2 } }, “open_graph_url”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “importance”: { “0-1”: 0, “1-2”: 0, “2-3”: 0, “3-4”: 109, “4-5”: 109, “5-6”: 103, “6-7”: 43, “7-8”: 28, “8-9”: 16, “9-10”: 800 }, “status_code”: { “200”: 1234 }, “title”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “twitter_card”: { “empty”: 0, “missing”: 0, “others”: 0, “values”: { “summary_large_image”: 1234 } }, “twitter_description”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “twitter_image”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “twitter_site”: { “empty”: 0, “missing”: 0, “others”: 0, “values”: { “@conductor”: 1234 } }, “twitter_title”: { “available”: 1234, “empty”: 0, “missing”: 0 }, “is_https”: { “true”: 1234, “false”: 0 }, “url_depth”: { “0”: 1, “1”: 15, “2”: 399, “3”: 29, “4”: 1000, “5”: 0, “6”: 0, “7”: 0, “8”: 0, “9”: 0, “10+”: 0 }, “domain”: { “www.conductor.de”: 1234 }, “lighthouse_cls”: { “good”: 1234, “needsImprovement”: 0, “bad”: 0 }, “lighthouse_fcp”: { “good”: 1234, “needsImprovement”: 0, “bad”: 0 }, “lighthouse_lcp”: { “good”: 1234, “needsImprovement”: 0, “bad”: 0 }, “lighthouse_performance”: { “good”: 1234, “needsImprovement”: 0, “bad”: 0 }, “lighthouse_si”: { “good”: 1234, “needsImprovement”: 0, “bad”: 0 }, “lighthouse_tbt”: { “good”: 1234, “needsImprovement”: 0, “bad”: 0 }, “lighthouse_tti”: { “good”: 1234, “needsImprovement”: 0, “bad”: 0 } } }, “data_captured_at”: “2022-08-04T15:23:01+02:00”, “is_data_golden”: false }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`health`	integer
`number_of_issues`	integer
`number_of_urls`	array
`number_of_urls.page`	integer
`number_of_urls.missing`	integer
`number_of_urls.redirect`	integer
`number_of_urls.server_error`	integer
`number_of_urls.unreachable`	integer
`number_of_urls_per_property`	array
`h1`	array
`h1.available`	integer
`h1.empty`	integer
`h1.missing`	integer
`health`	array
`health.0-100`	integer
`health.100-200`	integer
`health.200-300`	integer
`health.300-400`	integer
`health.400-500`	integer
`health.600-700`	integer
`health.800-900`	integer
`health.900-1000`	integer
`hreflang_language`	array
`hreflang_language.hreflang_attribute`	string
`hreflang_language.missing`	integer
`hreflang_language.other`	integer
`is_disallowed_in_robots_txt`	array
`is_disallowed_in_robots_txt.true`	integer
`is_disallowed_in_robots_txt.false`	integer
`is_in_sitemap`	array
`is_in_sitemap.true`	integer
`is_in_sitemap.false`	integer
`is_indexable`	array
`is_indexable.true`	integer
`is_indexable.false`	integer
`is_indexable_due_to_meta_robots`	array
`is_indexable_due_to_meta_robots.no`	integer
`is_indexable_due_to_meta_robots.not_applicable`	integer
`is_indexable_due_to_meta_robots.yes`	integer
`is_indexable_due_to_x_robots_tag`	array
`is_indexable_due_to_x_robots_tag.no`	integer
`is_linked`	array
`is_linked.true`	integer
`is_linked.false`	integer
`meta_description`	array
`meta_description.available`	integer
`meta_description.empty`	integer
`meta_description.missing`	integer
`open_graph_description`	array
`open_graph_description.available`	integer
`open_graph_description.empty`	integer
`open_graph_description.missing`	integer
`open_graph_image`	array
`open_graph_image.available`	integer
`open_graph_image.empty`	integer
`open_graph_image.missing`	integer
`open_graph_title`	array
`open_graph_title.available`	integer
`open_graph_title.empty`	integer
`open_graph_title.missing`	integer
`open_graph_type`	array
`open_graph_type.empty`	integer
`open_graph_type.missing`	integer
`open_graph_type.others`	integer
`open_graph_type.values`	array
`open_graph_type.values.name`	integer
`open_graph_URL`	array
`open_graph_URL.available`	integer
`open_graph_URL.empty`	integer
`open_graph_URL.missing`	integer
`importance`	array
`importance.0-1`	integer
`importance.1-2`	integer
`importance.2-3`	integer
`importance.3-4`	integer
`importance.4-5`	integer
`importance.6-7`	integer
`importance.8-9`	integer
`importance.9-10`	integer
`status_code`	array
`status_code.value`	integer
`title`	array
`title.available`	integer
`title.empty`	integer
`title.missing`	integer
`twitter_card`	array
`twitter_card.empty`	integer
`twitter_card.missing`	integer
`twitter_card.others`	integer
`twitter_card.values`	array
`twitter_card.values_name`	integer
`twitter_description`	array
`twitter_description.available`	integer
`twitter_description.empty`	integer
`twitter_description.missing`	integer
`twitter_image`	array
`twitter_image.available`	integer
`twitter_image.empty`	integer
`twitter_image.missing`	integer
`twitter_site`	array
`twitter_site.empty`	integer
`twitter_site.missing`	integer
`twitter_site.others`	integer
`twitter_site.values`	array
`twitter_site.values.name`	integer
`twitter_title`	array
`twitter_title.available`	integer
`twitter_title.empty`	integer
`twitter_title.missing`	integer
`is_https`	array
`is_https.true`	boolean
`is_https.false`	boolean
`url_depth`	array
`url_depth.0`	integer
`url_depth.1`	integer
`url_depth.2`	integer
`url_depth.3`	integer
`url_depth.4`	integer
`url_depth.6`	integer
`url_depth.7`	integer
`url_depth.8`	integer
`url_depth.9`	integer
`url_depth.10+`	integer
`domain`	array
`domain_name`	string
`data_captured_at`	datetime (ISO-8601 format)
`is_data_golden`	boolean

Specific errors when requesting statistics

404 Not found

{
  "error": "No statistics found for given scope"
}

This response means that the statistics for the given scope (website or segment) are not available at this time. They may or may not become available at a later time, depending on the actual content of the scope.

Retrieving list of pages for a website

/v2/data/pages

Use this endpoint to pull a list of pages belonging to one of your tracked websites or for a part of a tracked website.

Query Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

per_page (Required). Can be used with page and page_cursor for pagination. Value can be in range from 1 to 1000.

page (Optional) Can be used with per_page and page_cursor for pagination. Value can be 1 up to ceil(total / per_page). If page is higher than the maximum value, the urls array will be empty.

page_cursor (Optional). Can be used with page and per_page for pagination. Value should be a string retrieved from the next_page_cursor object in the request response for the previous page.

sort and direction (Optional). Can be used to determine sort order.

sort should be set to url
direction can be either asc or desc

Important

Make sure to use the page_cursor parameter when retrieving large paginated datasets to ensure smooth performance of the API.The page_cursor parameter allows you to specify the exact point in the dataset where the previous page (response) ended and the next page should start, optimizing the process of retrieving large paginated datasets.The page_cursor parameter takes precedence over the page parameter. This means that if the page_cursor parameter is used in the request URL, the page parameter should not be used at the same time.

Request Responses

200	Successful query execution. Each successful response contains 2 main keys: `total` count of URLs in result set for given query `urls` paginated URLs based on query parameters `per_page`, `page`, and `page_cursor` Schema: See below Example { “data”: { “next_page_cursor”: “WyIvencvY3NoZWxwL2FydGljbGUv2YPZit”, “total”: 1, “urls”: [ { “aa_average_time_spent_on_site”: null, “aa_bounce_rate”: null, “aa_page_views”: null, “aa_revenue”: null, “aa_unique_visitors”: null, “analytics_services”: [ “google_analytics” ], “app_url”: “https://app.cm.conductor.com/websites/1-2345/pages/123456”, “canonical”: null, “canonical_type”: “none”, “custom_elements”: [], “ga_average_time”: null, “ga_bounce_rate”: null, “ga_page_value”: null, “ga_page_views”: null, “ga_unique_page_views”: null, “ga_v4_active_users”: null, “ga_v4_average_engagement_time”: null, “ga_v4_engagement_rate”: null, “ga_v4_screen_page_views”: null, “gsc_clicks”: null, “gsc_ctr”: null, “gsc_impressions”: null, “gsc_position”: null, “h1”: “null”, “health”: 920, “hreflang_language”: null, “is_disallowed_in_robots_txt”: false, “is_https”: false, “is_in_sitemap”: false, “is_indexable”: false, “is_indexable_due_to_meta_robots”: false, “is_indexable_due_to_x_robots_tag”: true, “is_linked”: true, “lfa_bing_desktop_frequency”: null, “lfa_bing_desktop_last_visit”: null, “lfa_bing_frequency”: null, “lfa_bing_last_visit”: null, “lfa_bing_mobile_frequency”: null, “lfa_bing_mobile_last_visit”: null, “lfa_google_desktop_frequency”: null, “lfa_google_desktop_last_visit”: null, “lfa_google_frequency”: null, “lfa_google_last_visit”: null, “lfa_google_mobile_frequency”: null, “lfa_google_mobile_last_visit”: null, “lfa_openai_bot_frequency”: null, “lfa_openai_bot_last_visit”: null, “lfa_openai_desktop_frequency”: null, “lfa_openai_desktop_last_visit”: null, “lfa_openai_frequency”: null, “lfa_openai_last_visit”: null, “lfa_openai_search_frequency”: null, “lfa_openai_search_last_visit”: null, “lfa_openai_user_frequency”: null, “lfa_openai_user_last_visit”: null, “lfa_perplexity_bot_frequency”: null, “lfa_perplexity_bot_last_visit”: null, “lfa_perplexity_desktop_frequency”: null, “lfa_perplexity_desktop_last_visit”: null, “lfa_perplexity_frequency”: null, “lfa_perplexity_last_visit”: null, “lfa_perplexity_user_frequency”: null, “lfa_perplexity_user_last_visit”: null, “lighthouse_cls”: null, “lighthouse_fcp”: null, “lighthouse_lcp”: null, “lighthouse_performance”: null, “lighthouse_si”: null, “lighthouse_tbt”: null, “lighthouse_tti”: null, “link_amp”: null, “link_next”: null, “link_prev”: null, “meta_description”: “null”, “mobile_variant”: null, “number_of_hreflangs”: 0, “number_of_incoming_internal_canonicals”: 0, “number_of_incoming_internal_links”: 0, “number_of_incoming_internal_redirects”: 0, “number_of_outgoing_external_links”: 5, “number_of_outgoing_internal_links”: 147, “open_graph_description”: null, “open_graph_image”: null, “open_graph_title”: null, “open_graph_type”: null, “open_graph_url”: null, “redirect”: null, “relevance”: 3, “schema_org_number_of_types”: 0, “schema_org_types”: [], “segments”: [], “status_code”: 200, “tag_managers”: null, “time_document_download”: 12, “title”: “null”, “twitter_card”: null, “twitter_description”: null, “twitter_image”: null, “twitter_site”: null, “twitter_title”: null, “type”: “page”, “url”: “https://www.conductor.com/”, “url_depth”: 0, “url_path”: ”/”, “visual_analytics_services”: null } ] }, “data_captured_at”: “2022-08-16T11:24:27+02:00”, “is_data_golden”: false }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`next_page_cursor`	string
`urls`	array
`urls.aa_average_time_spent_on_site`	integer (seconds)
`urls.aa_bounce_rate`	float (percentage)
`urls.aa_page_views`	integer
`urls.aa_unique_visitors`	integer
`urls.aa_revenue`	float
`urls.analytics_services`	string
`urls.app_url`	string
`urls.canonical`	string
`urls.canonical_type`	string
`urls.custom_elements`	array
`urls.custom_elements.custom_element_name`	string/number/boolean/date (depending on configuration)
`urls.ga_average_time`	integer (seconds)
`urls.ga_bounce_rate`	float (percentage)
`urls.ga_page_views`	integer
`urls.ga_unique_page_views`	integer
`urls.ga_page_value`	float
`urls.ga_v4_active_users`	integer
`urls.ga_v4_average_engagement_time`	integer (seconds)
`urls.ga_v4_engagement_rate`	float (percentage)
`urls.ga_v4_screen_page_views`	integer
`urls.gsc_clicks`	integer
`urls.gsc_impressions`	integer
`urls.gsc_ctr`	float (percentage)
`urls.gsc_position`	float
`urls.gsc_date_range`	array
`urls.gsc_date_range.since`	date (YYYY-MM-DD)
`urls.gsc_date_range.until`	date (YYYY-MM-DD)
`urls.health`	number
`urls.hreflang_language`	string
`urls.is_disallowed_in_robots_txt`	boolean
`urls.is_https`	boolean
`urls.is_in_sitemap`	boolean
`urls.is_indexable`	boolean
`urls.is_indexable_due_to_meta_robots`	boolean
`urls.is_indexable_due_to_x_robots_tag`	boolean
`urls.is_linked`	boolean
`urls.legacy_id_fallback`	string
`urls.lfa_bing_desktop_frequency`	array
`urls.lfa_bing_desktop_frequency.value`	float
`urls.lfa_bing_desktop_frequency.unit`	string
`urls.lfa_bing_desktop_last_visit`	datetime (ISO-8601 format)
`urls.lfa_bing_frequency`	array
`urls.lfa_bing_frequency.value`	float
`urls.lfa_bing_frequency.unit`	string
`urls.lfa_bing_last_visit`	datetime (ISO-8601 format)
`urls.lfa_bing_mobile_frequency`	array
`urls.lfa_bing_mobile_frequency.value`	float
`urls.lfa_bing_mobile_frequency.unit`	string
`urls.lfa_bing_mobile_last_visit`	datetime (ISO-8601 format)
`urls.lfa_google_desktop_frequency`	array
`urls.lfa_google_desktop_frequency.value`	float
`urls.lfa_google_desktop_frequency.unit`	string
`urls.lfa_google_desktop_last_visit`	datetime (ISO-8601 format)
`urls.lfa_google_frequency`	array
`urls.lfa_google_frequency.value`	float
`urls.lfa_google_frequency.unit`	string
`urls.lfa_google_last_visit`	datetime (ISO-8601 format)
`urls.lfa_google_mobile_frequency`	array
`urls.lfa_google_mobile_frequency.value`	float
`urls.lfa_google_mobile_frequency.unit`	string
`urls.lfa_google_mobile_last_visit`	datetime (ISO-8601 format)
`urls.lfa_openai_bot_frequency`	array
`urls.lfa_openai_bot_frequency.value`	float
`urls.lfa_openai_bot_frequency.unit`	string
`urls.lfa_openai_bot_last_visit`	datetime (ISO-8601 format)
`urls.lfa_openai_desktop_frequency`	array
`urls.lfa_openai_desktop_frequency.value`	float
`urls.lfa_openai_desktop_frequency.unit`	string
`urls.lfa_openai_desktop_last_visit`	datetime (ISO-8601 format)
`urls.lfa_openai_frequency`	array
`urls.lfa_openai_frequency.value`	float
`urls.lfa_openai_frequency.unit`	string
`urls.lfa_openai_last_visit`	datetime (ISO-8601 format)
`urls.lfa_openai_search_frequency`	array
`urls.lfa_openai_search_frequency.value`	float
`urls.lfa_openai_search_frequency.unit`	string
`urls.lfa_openai_search_last_visit`	datetime (ISO-8601 format)
`urls.lfa_openai_user_frequency`	array
`urls.lfa_openai_user_frequency.value`	float
`urls.lfa_openai_user_frequency.unit`	string
`urls.lfa_openai_user_last_visit`	datetime (ISO-8601 format)
`urls.lfa_perplexity_bot_frequency`	array
`urls.lfa_perplexity_bot_frequency.value`	float
`urls.lfa_perplexity_bot_frequency.unit`	string
`urls.lfa_perplexity_bot_last_visit`	datetime (ISO-8601 format)
`urls.lfa_perplexity_desktop_frequency`	array
`urls.lfa_perplexity_desktop_frequency.value`	float
`urls.lfa_perplexity_desktop_frequency.unit`	string
`urls.lfa_perplexity_desktop_last_visit`	datetime (ISO-8601 format)
`urls.lfa_perplexity_frequency`	array
`urls.lfa_perplexity_frequency.value`	float
`urls.lfa_perplexity_frequency.unit`	string
`urls.lfa_perplexity_last_visit`	datetime (ISO-8601 format)
`urls.lfa_perplexity_user_frequency`	array
`urls.lfa_perplexity_user_frequency.value`	float
`urls.lfa_perplexity_user_frequency.unit`	string
`urls.lfa_perplexity_user_last_visit`	datetime (ISO-8601 format)
`urls.lighthouse_performance`	array
`urls.lighthouse_performance.value`	integer
`urls.lighthouse_performance.range`	string
`urls.lighthouse_cls`	array
`urls.lighthouse_cls.value`	float
`urls.lighthouse_cls.range`	string
`urls.lighthouse_fcp`	array
`urls.lighthouse_fcp.value`	integer (milliseconds)
`urls.lighthouse_fcp.range`	string
`urls.lighthouse_lcp`	array
`urls.lighthouse_lcp.value`	integer (milliseconds)
`urls.lighthouse_lcp.range`	string
`urls.lighthouse_si`	array
`urls.lighthouse_si.value`	integer (milliseconds)
`urls.lighthouse_si.range`	string
`urls.lighthouse_tbt`	array
`urls.lighthouse_tbt.value`	integer (milliseconds)
`urls.lighthouse_tbt.range`	string
`urls.lighthouse_tti`	array
`urls.lighthouse_tti.value`	integer (milliseconds)
`urls.lighthouse_tti.range`	string
`urls.link_amp`	string (absolute URL)
`urls.link_next`	string (absolute URL)
`urls.link_prev`	string (absolute URL)
`urls.mobile_variant`	string (absolute URL)
`urls.title`	string
`urls.url_id`	string
`urls.is_video`	boolean
`urls.video_duration`	float (seconds)
`urls.video_title`	string
`urls.webp`	string (absolute URL)
`urls.watched_events`	array
`urls.watched_events.watched_event_name`	string
`data_captured_at`	datetime (ISO-8601 format)
`is_data_golden`	boolean

Retrieving data for a specific page within a website

/v2/data/page

Use this endpoint to get data for a specific page belonging to a website in your account.

Query Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

url (Required). Can be inferred from the value of the url object for a specific page returned in the urls array called by the GET /v2/data/pages endpoint described above

Response for a page

200	Successful query execution Schema: See below Examples Successful response for a page with a 2xx HTTP response code (Successful) { “data”: { “url”: “https://www.conductor.com”, “url_unique_id”: “1-234”, “is_https”: true, “ga_v4_active_users”: 10, “ga_v4_average_engagement_time”: 10, “ga_v4_date_range”: { “since”: “2022-05-16”, “until”: “2022-08-14” }, “ga_v4_engagement_rate”: 10, “ga_v4_screen_page_views”: 10, “gsc_clicks”: 10, “gsc_ctr”: 10, “gsc_date_range”: { “since”: “2022-05-16”, “until”: “2022-08-14” }, “gsc_impressions”: 10, “gsc_position”: 10, “health”: 881, “is_disallowed_in_robots_txt”: false, “is_indexable”: true, “is_indexable_due_to_meta_robots”: “yes”, “is_indexable_due_to_x_robots_tag”: “yes”, “is_in_sitemap”: true, “lfa_bing_desktop_frequency”: null, “lfa_bing_desktop_last_visit”: null, “lfa_bing_frequency”: null, “lfa_bing_last_visit”: null, “lfa_bing_mobile_frequency”: null, “lfa_bing_mobile_last_visit”: null, “lfa_google_desktop_frequency”: null, “lfa_google_desktop_last_visit”: null, “lfa_google_frequency”: null, “lfa_google_last_visit”: null, “lfa_google_mobile_frequency”: null, “lfa_google_mobile_last_visit”: null, “lfa_openai_desktop_frequency”: null, “lfa_openai_desktop_last_visit”: null, “lfa_openai_search_last_visit”: null, “lfa_openai_search_frequency”: null, “lfa_openai_user_last_visit”: null, “lfa_openai_user_frequency”: null, “lfa_openai_bot_last_visit”: null, “lfa_openai_bot_frequency”: null, “lfa_openai_frequency”: null, “lfa_openai_last_visit”: null, “lfa_perplexity_desktop_frequency”: null, “lfa_perplexity_desktop_last_visit”: null, “lfa_perplexity_user_last_visit”: null, “lfa_perplexity_user_frequency”: null, “lfa_perplexity_bot_last_visit”: null, “lfa_perplexity_bot_frequency”: null, “lfa_perplexity_frequency”: null, “lfa_perplexity_last_visit”: null, “lighthouse_cls”: { “value”: 0, “range”: “good” }, “lighthouse_fcp”: { “value”: 1000, “range”: “good” }, “lighthouse_lcp”: { “value”: 2000, “range”: “good” }, “lighthouse_performance”: { “value”: 95, “range”: “good” }, “lighthouse_si”: { “value”: 3700, “range”: “needsImprovement” }, “lighthouse_tbt”: { “value”: 669, “range”: “bad” }, “lighthouse_tti”: { “value”: 2000, “range”: “good” }, “relevance”: 9.33, “status_code”: 200, “type”: “page”, “enrichment_fields_data”: {}, “content”: [ { “type”: “canonical”, “content”: “null” }, { “type”: “link_alternate_hreflang”, “content”: “null”, “hreflang”: “en” }, { “type”: “link_alternate_hreflang”, “content”: “null”, “hreflang”: “x-default” }, { “type”: “title”, “content”: “Some Title” }, { “type”: “meta_description”, “content”: “Some Meta Description” }, { “type”: “h1”, “content”: “null” }, { “type”: “open_graph_description”, “content”: “null” }, { “type”: “open_graph_image”, “content”: “null” }, { “type”: “open_graph_title”, “content”: “null” }, { “type”: “open_graph_type”, “content”: “null” }, { “type”: “open_graph_url”, “content”: “null” }, { “type”: “twitter_card”, “content”: “null” }, { “type”: “twitter_site”, “content”: “null” }, { “type”: “twitter_title”, “content”: “null” }, { “type”: “twitter_description”, “content”: “null” }, { “type”: “twitter_image”, “content”: “null” }, { “type”: “google_analytics”, “content”: “UA-12345678-1” }, { “type”: “google_tag_manager”, “content”: “GTM-AB12345” } ], “schema_org”: [], “segments”: [ “1111111” ], “app_url”: “https://app.cm.conductor.com/websites/1-12345/pages/123456789”, “time_document_download”: 123, “open_issues”: [ { “name”: “analytics/visual_analytics_missing” }, { “name”: “open_graph/description_incorrect_length” }, { “name”: “open_graph/title_incorrect_length” } ], “custom_elements”: {}, “unstable_last_checked_at”: “2022-08-15T13:32:12+02:00” }, “data_captured_at”: “2022-08-15T13:32:29+02:00”, “is_data_golden”: false } Successful response for a page with a 3xx HTTP response code (Redirects) { “data”: { “url”: “https://cm.conductor.com/”, “url_unique_id”: “123345”, “is_https”: true, “is_disallowed_in_robots_txt”: false, “is_indexable”: false, “is_indexable_due_to_meta_robots”: “not_applicable”, “is_indexable_due_to_x_robots_tag”: “not_applicable”, “is_in_sitemap”: false, “redirect”: { “location”: “https://www.conductor.com/”, “url”: “https://www.conductor.com/” }, “status_code”: 301, “type”: “redirect”, “enrichment_fields_data”: {}, “segments”: [], “app_url”: “https://app.cm.conductor.com/websites/5-2457491/pages/12334563485638745638465837465836”, “time_document_download”: 123, “unstable_last_checked_at”: “2022-08-15T06:28:42+02:00” }, “data_captured_at”: “2022-08-15T13:55:35+02:00”, “is_data_golden”: false } Successful response for a page with a 4xx HTTP response code (Missing) { “data”: { “url”: “https://cm.conductor.com/this-page-does-not-exist/”, “url_unique_id”: “123345”, “is_https”: true, “is_disallowed_in_robots_txt”: false, “is_indexable”: false, “is_indexable_due_to_meta_robots”: “not_applicable”, “is_indexable_due_to_x_robots_tag”: “not_applicable”, “is_in_sitemap”: false, “status_code”: 404, “type”: “missing”, “enrichment_fields_data”: {}, “segments”: [], “app_url”: “https://app.cm.conductor.com/websites/5-2457491/pages/12334563485638745638465837465836”, “time_document_download”: 123, “unstable_last_checked_at”: “2022-08-15T06:28:42+02:00” }, “data_captured_at”: “2022-08-15T13:55:35+02:00”, “is_data_golden”: false }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Examples `{ “error”: “Requested website ID was not found” }` { “error”: “Requested URL was not found” } This response means that the URL passed in the request is not monitored by Conductor Monitoring. { “error”: “Requested URL cannot be provided via Reporting API” } This response means that data for the URL passed in the request is not available via the Reporting API.
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`url`	string (absolute URL)
`is_https`	boolean
`ga_average_time`	integer (seconds)
`ga_bounce_rate`	float (percentage)
`ga_page_views`	integer
`ga_unique_page_views`	integer
`ga_page_value`	float
`ga_date_range`	array
`ga_date_range.since`	date (YYYY-MM-DD)
`ga_date_range.until`	date (YYYY-MM-DD)
`ga_v4_active_users`	integer
`ga_v4_average_engagement_time`	integer (seconds)
`ga_v4_engagement_rate`	float (percentage)
`ga_v4_screen_page_views`	integer
`ga_v4_date_range`	array
`ga_v4_date_range.since`	date (YYYY-MM-DD)
`ga_v4_date_range.until`	date (YYYY-MM-DD)
`gsc_clicks`	integer
`gsc_impressions`	integer
`gsc_ctr`	float (percentage)
`gsc_position`	float
`gsc_date_range`	array
`gsc_date_range.since`	date (YYYY-MM-DD)
`gsc_date_range.until`	date (YYYY-MM-DD)
`health`	number
`relevance`	float
`is_disallowed_in_robots_txt`	boolean
`is_indexable`	boolean
`is_indexable_due_to_meta_robots`	boolean
`is_indexable_due_to_x_robots_tag`	boolean
`is_in_sitemap`	boolean
`status_code`	integer
`time_document_download`	number
`type`	string
`content`	array
`content.type`	string
`content.content`	string
`custom_elements`	array
`custom_elements.custom_element_name`	string/number/boolean/date (depending on configuration)
`schema_org`	array (containing different Schema properties as defined by schema.org)
`segments`	array of strings (containing Segment IDs)
`app_url`	string (absolute URL)
`open_issues`	array
`open_issues.name`	string (see List of issues)
`lfa_bing_desktop_frequency`	array
`lfa_bing_desktop_frequency.value`	float
`lfa_bing_desktop_frequency.unit`	string
`lfa_bing_desktop_last_visit`	datetime (ISO-8601 format)
`lfa_bing_frequency`	array
`lfa_bing_frequency.value`	float
`lfa_bing_frequency.unit`	string
`lfa_bing_last_visit`	datetime (ISO-8601 format)
`lfa_bing_mobile_frequency`	array
`lfa_bing_mobile_frequency.value`	float
`lfa_bing_mobile_frequency.unit`	string
`lfa_bing_mobile_last_visit`	datetime (ISO-8601 format)
`lfa_google_desktop_frequency`	array
`lfa_google_desktop_frequency.value`	float
`lfa_google_desktop_frequency.unit`	string
`lfa_google_desktop_last_visit`	datetime (ISO-8601 format)
`lfa_google_frequency`	array
`lfa_google_frequency.value`	float
`lfa_google_frequency.unit`	string
`lfa_google_last_visit`	datetime (ISO-8601 format)
`lfa_google_mobile_frequency`	array
`lfa_google_mobile_frequency.value`	float
`lfa_google_mobile_frequency.unit`	string
`lfa_google_mobile_last_visit`	datetime (ISO-8601 format)
`lfa_openai_bot_frequency`	array
`lfa_openai_bot_frequency.value`	float
`lfa_openai_bot_frequency.unit`	string
`lfa_openai_bot_last_visit`	datetime (ISO-8601 format)
`lfa_openai_desktop_frequency`	array
`lfa_openai_desktop_frequency.value`	float
`lfa_openai_desktop_frequency.unit`	string
`lfa_openai_desktop_last_visit`	datetime (ISO-8601 format)
`lfa_openai_frequency`	array
`lfa_openai_frequency.value`	float
`lfa_openai_frequency.unit`	string
`lfa_openai_last_visit`	datetime (ISO-8601 format)
`lfa_openai_search_frequency`	array
`lfa_openai_search_frequency.value`	float
`lfa_openai_search_frequency.unit`	string
`lfa_openai_search_last_visit`	datetime (ISO-8601 format)
`lfa_openai_user_frequency`	array
`lfa_openai_user_frequency.value`	float
`lfa_openai_user_frequency.unit`	string
`lfa_openai_user_last_visit`	datetime (ISO-8601 format)
`lfa_perplexity_bot_frequency`	array
`lfa_perplexity_bot_frequency.value`	float
`lfa_perplexity_bot_frequency.unit`	string
`lfa_perplexity_bot_last_visit`	datetime (ISO-8601 format)
`lfa_perplexity_desktop_frequency`	array
`lfa_perplexity_desktop_frequency.value`	float
`lfa_perplexity_desktop_frequency.unit`	string
`lfa_perplexity_desktop_last_visit`	datetime (ISO-8601 format)
`lfa_perplexity_frequency`	array
`lfa_perplexity_frequency.value`	float
`lfa_perplexity_frequency.unit`	string
`lfa_perplexity_last_visit`	datetime (ISO-8601 format)
`lfa_perplexity_user_frequency`	array
`lfa_perplexity_user_frequency.value`	float
`lfa_perplexity_user_frequency.unit`	string
`lfa_perplexity_user_last_visit`	datetime (ISO-8601 format)
`lighthouse_performance`	array
`lighthouse_performance.value`	integer
`lighthouse_performance.range`	string
`lighthouse_cls`	array
`lighthouse_cls.value`	float
`lighthouse_cls.range`	string
`lighthouse_fcp`	array
`lighthouse_fcp.value`	integer (milliseconds)
`lighthouse_fcp.range`	string
`lighthouse_lcp`	array
`lighthouse_lcp.value`	integer (milliseconds)
`lighthouse_lcp.range`	string
`lighthouse_si`	array
`lighthouse_si.value`	integer (milliseconds)
`lighthouse_si.range`	string
`lighthouse_tbt`	array
`lighthouse_tbt.value`	integer (milliseconds)
`lighthouse_tbt.range`	string
`lighthouse_tti`	array
`lighthouse_tti.value`	integer (milliseconds)
`lighthouse_tti.range`	string
`unstable_last_checked_at`	datetime (ISO-8601 format)
`data_captured_at`	datetime (ISO-8601 format)
`is_data_golden`	boolean

Retrieving log file data for a website

/v2/data/page_lfa

Use this endpoint to return log file data from Conductor Monitoring’s Log File Analysis feature for your monitored pages. Log File Analysis data gives AEO and SEO professionals a better understanding of what search engines and AI bot crawlers are actually doing on their websites. Values returned for each day through this endpoint represent the number of times each crawler visited the page or pages for which you are querying data.

Query Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

urls (Required). A list of up to 50 valid URL strings from your website. Note: if any of these URLs are unknown, the endpoint returns a 404 error. This list can be added using repeated query parameters as follows: urls[]=https://example.com/page1&urls[]=https://example.com/page2&urls[]=https://example.com/page3…

date_range (Optional). This two-field parameter represents the range for which you want to query data. By default, when this parameter is not included in the request, the endpoint returns data for the most recent 30 days. Both of the following fields must be included for the date_range parameter to work:

date_range[start_date]. Enter the start date from which to query data.
date_range[end_date]. Enter an end date up to which you want to query data.

This parameter must be formatted as follows: date_range[start_date]=YYYY-MM-DD&date_range[end_date]=YYYY-MM-DD

Request Responses

200	Successful query execution Schema: See below Example { “data”: { “urls”: [ { “url”: “https://www.example.com/”, “visits_per_day”: { “lfa_bing_desktop”: { “2025-08-28”: 2, “2025-08-29”: 1, “2025-08-30”: 2, … }, “lfa_bing_mobile”: {…}, “lfa_google_desktop”: {…}, “lfa_google_mobile”: {…}, “lfa_openai_bot”: {…}, “lfa_openai_search”: {…}, “lfa_openai_user”: {…}, “lfa_perplexity_bot”: {…}, “lfa_perplexity_user”: {…} } }, { “url”: “https://www.example.com/about-us/”, “visits_per_day”: {…} }, {…} ] }, “data_captured_at”: “2026-01-06T16:07:41+01:00” }
400	Log File Analysis is not enabled for this website in Conductor Monitoring. Examples `{ “error”: “Log File Analysis is not enabled” }`
403	Not all URLs are one of the following types: Page Redirect Server error Missing Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “error”: “Requested URL cannot be provided via Reporting API (url)” }`
404	Not found Example `{ “error”: “Requested URL was not found (url)” }`

Schema data types for this endpoint

Property	Data Type
`urls`	array
`urls.url`	string (absolute URL)
`urls.visits_per_day`	array
`urls.visits_per_day.lfa_bing_desktop`	array
`urls.visits_per_day.lfa_bing_desktop.YYYY-MM-DD`	integer
`urls.visits_per_day.lfa_bing_mobile`	array
`urls.visits_per_day.lfa_bing_mobile.YYYY-MM-DD`	integer
`urls.visits_per_day.lfa_google_desktop`	array
`urls.visits_per_day.lfa_google_desktop.YYYY-MM-DD`	integer
`urls.visits_per_day.lfa_google_mobile`	array
`urls.visits_per_day.lfa_google_mobile.YYYY-MM-DD`	integer
`urls.visits_per_day.lfa_openai_bot`	array
`urls.visits_per_day.lfa_openai_bot.YYYY-MM-DD`	integer
`url.visits_per_day.lfa_openai_search`	array
`url.visits_per_day.lfa_openai_search.YYYY-MM-DD`	integer
`url.visits_per_day.lfa_openai_user`	array
`url.visits_per_day.lfa_openai_user.YYYY-MM-DD`	integer
`url.visits_per_day.lfa_perplexity_bot`	array
`url.visits_per_day.lfa_perplexity_bot.YYYY-MM-DD`	integer
`url.visits_per_day.lfa_perplexity_user`	array
`url.visits_per_day.lfa_perplexity_user.YYYY-MM-DD`	integer
`data_captured_at`	datetime (ISO-8601 format)

Retrieving list of alerts for a website

/v2/alerts

Use this endpoint to get a list of alerts for a website monitored in your account.

Query Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

Request Responses

200	Successful query execution Schema: See below Example { “data”: [ { “id”: “1”, “app_url”: “https://app.cm.conductor.com/websites/1-234/alerts?alert=1”, “date_last_updated”: “2022-08-04T13:40:50+02:00”, “date_opened”: “2022-07-27T09:34:44+02:00”, “scope”: “website”, “type”: “content_change.meta_description” }, { “id”: “2”, “app_url”: “https://app.cm.conductor.com/websites/1-234/alerts?alert=2”, “date_last_updated”: “2022-08-04T13:40:50+02:00”, “date_opened”: “2022-07-26T07:03:25+02:00”, “scope”: “website”, “type”: “pages_became_non_indexable” } ] }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`id`	string
`app_url`	string (absolute URL)
`date_last_updated`	datetime (ISO 8601 format)
`date_opened`	datetime (ISO 8601 format)
`scope`	string
`type`	string

Retrieving list of pages for a website alert

/v2/alerts/alert_pages

Use this endpoint to get a list of pages for a specific website alert.

GET /v2/alerts/alert_pages?website_id=<website_id>&alert_id=<alert_id>&page=1&per_page=100

Query Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

alert_id (Required). Can be inferred from the GET /v2/alerts endpoint described above.

page and per_page (Optional). Can be used for pagination.

Request Responses

200	Successful query execution Schema: See below Example { “data”: { “total”: 1, “urls”: [ { “app_url”: “https://app.cm.conductor.com/websites/1-2/pages/3”, “relevance”: 6.05, “segments”: [], “status”: “entered”, “url”: “https://www.conductor.com/”, }, ] } }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`total`	integer
`urls`	array
`urls.app_url`	string (absolute URL)
`urls.relevance`	float
`segments`	array of strings (containing Segment IDs, see Retrieving a list of segments)
`status`	string
`urls.url`	string (absolute URL)

Retrieving a list of issues for a website or segment

/v2/data/issues

Use this endpoint to get a list of issues for a specific website in your account.

GET /v2/data/issues?website_id=<website_id>

Query Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

scope (Required). Determines whether data for the whole website is returned or specific parts. Potential values:

website. Retrieves data for the whole website.
segment:{segment_id}. Retrieves data for a specific segment. Segment IDs can be inferred with the GET /v2/entities/segments endpoint described above.
segment_label:{segment_label}. Retrieves data for a specific segment. Segment label can be inferred from the GET /v2/entities/segments endpoint described above.

Request Responses

200	Successful query execution Schema: See below Example { “data”: [ { “name”: “analytics/analytics_missing”, “points_gained”: 79, “points_to_gain”: 0, “scope”: “pages”, “type”: “opportunity”, “tags”: “seo”, “pages_per_issue_state”: { “absolute_number”: { “open”: 0, “closed”: 0, “ignored”: 527, “not_applicable”: 0, “not_required”: 0, “unknown”: 0 }, “percentage”: { “open”: 0, “closed”: 0, “ignored”: 100, “not_applicable”: 0, “not_required”: 0, “unknown”: 0 } } }, ], “data_captured_at”: “2022-08-04T14:03:19+02:00”, “is_data_golden”: false }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`name`	string
`points_gained`	integer
`points_to_gain`	integer
`type`	string (enum: `critical`, `fix`, `opportunity`)
`tags`	array (enum: `aeo`, `seo`)
`scope`	string
`pages_per_issue_state`	array
`pages_per_issue_state.absolute_number.open`	integer
`pages_per_issue_state.absolute_number.closed`	integer
`pages_per_issue_state.absolute_number.ignored`	integer
`pages_per_issue_state.absolute_number.not_applicable`	integer
`pages_per_issue_state.absolute_number.not_required`	integer
`pages_per_issue_state.absolute_number.unknown`	integer
`pages_per_issue_state.percentage.open`	integer
`pages_per_issue_state.percentage.closed`	integer
`pages_per_issue_state.percentage.ignored`	integer
`pages_per_issue_state.percentage.not_applicable`	integer
`pages_per_issue_state.percentage.not_required`	integer
`pages_per_issue_state.percentage.unknown`	integer
`data_captured_at`	datetime (ISO-8601 format)
`is_data_golden`	boolean

Retrieving list of pages for a website issue

/v2/data/affected_pages

Use this endpoint to get list of pages for a specific website issue.

Query Parameters

website_id (Required). Can be inferred from the GET /v2/entities/websites endpoint described above.

issue (Required). Can be inferred from the GET /v2/data/issues endpoint described above.

page and per_page (Optional). Can be used for pagination.

Request Responses

200	Successful query execution Schema: See below Example { “data”: { “total”: 1, “urls”: [ { “app_url”: “https://app.cm.conductor.com/websites/1-123455/pages/123455678”, “relevance”: 9.33, “segments”: [ “88611”, ], “url”: “https://www.conductor.com/”, “url_path”: ”/” }, ] }, “data_captured_at”: “2022-08-16T12:42:35+02:00”, “is_data_golden”: false }
401	Unauthorized: Missing authentication token. The request was received but it’s lacking an authorization token and can therefore not be processed. Make sure to correctly set the Authorization header. Authentication failed. The request could not be processed because the supplied API token is invalid or expired. Examples `{ “code”: “auth_missing_token”, “message”: “Authentication token must be passed in Authorization HTTP header.”, “errors”: [] } or { “code”: “auth_failed”, “message”: “Authentication token is expired or invalid.”, “errors”: [] }`
403	Forbidden: Terms of use not accepted. You have not accepted Reporting API Terms of Use yet. You need to accept them in Account Settings before you start using Conductor Monitoring Reporting API. Our CDN is blocking your user agent, which might be a generic or default user agent like Python urllib3. Changing the user agent to something less generic or more closely resembling a browser often bypasses these restrictions. Example `{ “code”: “terms_of_use_not_accepted”, “message”: “Reporting API Terms of Use have not been accepted yet. Please accept Terms of Use in Account Settings.”, “errors”: [] }`
404	Not found Example `{ “error”: “Requested website ID was not found” }`
422	Unprocessable Entity. The request was received, but the authorization wasn’t formatted correctly. Make sure to correctly configure the Authorization header as described in the Authentication section above.

Schema data types for this endpoint

Property	Data Type
`total`	integer
`urls`	array
`urls.app_url`	string (absolute URL)
`urls.relevance`	float
`segments`	array of strings (containing Segment IDs)
`urls.url`	string (absolute URL)
`urls.path`	string (absolute URL)
`data_captured_at`	datetime (ISO-8601 format)
`is_data_golden`	boolean

List of issues

Issue	Issue Tag	Type	Description
`analytics/analytics_missing`	seo	opportunity	No analytics installed
`analytics/visual_analytics_missing`	seo	opportunity	No visual analytics installed
`h1/duplicate`	aeo, seo	fix	H1 heading is not unique
`h1/incorrect_length`	aeo, seo	fix	H1 heading has incorrect length
`h1/missing`	aeo, seo	fix	H1 heading is missing
`h1/too_many`	aeo, seo	fix	More than one H1 heading
`canonical_link/incorrectly_canonicalized`	aeo, seo	fix	Canonical link to other page present on non-indexable page
`canonical_link/missing`	aeo, seo	fix	Canonical link is missing
`canonical_link/points_to_unindexable`	aeo, seo	critical	Canonical link is pointing to non-indexable page
`canonical_link/too_many`	aeo, seo	fix	More than one canonical link
`content_depth/html_size_too_big`	aeo, seo	opportunity	Content size greater than 2,097,152 bytes
`content_depth/body_empty`	aeo, seo	critical	No content in <body>
`content_depth/body_size_too_big`	aeo, seo	opportunity	Word count in <main> greater than 5000 words
`content_depth/body_size_too_small`	aeo, seo	critical	Word count in <main> fewer than 600 words
`content_depth/text_to_code_ratio`	aeo, seo	fix	Text-to-code ratio less than 10%
`content_depth/rich_text_elements_are_missing`	aeo, seo	fix	Rich text elements (lists/quotes/tables ) not present in <main>
`images/alt_attribute`	aeo, seo	fix	Images are missing alt-attribute
`links/broken`	aeo, seo	critical	Page contains broken links
`links/redirected`	aeo, seo	fix	Page contains links to redirects
`links/to_canonicalized`	aeo, seo	fix	Page contains links to canonicalized URLs
`meta_description/duplicate`	aeo, seo	fix	Meta description is not unique
`meta_description/incorrect_length`	aeo, seo	fix	Meta description has incorrect length
`meta_description/missing`	aeo, seo	fix	Meta description is missing
`meta_description/too_many`	aeo, seo	fix	There are multiple meta descriptions on the page
`title/duplicate`	aeo, seo	fix	Page title is not unique
`title/incorrect_length`	aeo, seo	fix	Page title has incorrect length
`title/missing`	aeo, seo	critical	Title is missing
`title/too_many`	aeo, seo	fix	There are multiple titles on pages
`open_graph/description_incorrect_length`	seo	opportunity	Open Graph description has incorrect length
`open_graph/description_missing`	seo	opportunity	Open Graph description is missing
`open_graph/image_missing`	seo	opportunity	Open Graph image is missing
`open_graph/title_incorrect_length`	seo	opportunity	Open Graph title has incorrect length
`open_graph/title_missing`	seo	opportunity	Open Graph title is missing
`open_graph/url_missing`	seo	opportunity	Open Graph URL is missing
`twitter_cards/description_incorrect_length`	seo	opportunity	Twitter Cards description has incorrect length
`twitter_cards/description_missing`	seo	opportunity	Twitter Cards description is missing
`twitter_cards/image_missing`	seo	opportunity	Twitter Cards image is missing
`twitter_cards/site_missing`	seo	opportunity	Twitter Cards site property is missing
`twitter_cards/title_incorrect_length`	seo	opportunity	Twitter Cards title has incorrect length
`twitter_cards/title_missing`	seo	opportunity	Twitter Cards title is missing
`twitter_cards/type_invalid`	seo	opportunity	Twitter Cards type value is not valid
`twitter_cards/type_missing`	seo	opportunity	Twitter Cards type is not present
`xml_sitemap/incorrectly_missing`	aeo, seo	critical	Page is not included in XML sitemap
`xml_sitemap/incorrectly_present`	aeo, seo	fix	Pages incorrectly present in XML sitemap
`hreflang/conflicting_targets`	seo	fix	Hreflang attribute value is pointed to multiple targets
`hreflang/invalid_target`	seo	fix	Invalid hreflang target present
`hreflang/invalid_value`	seo	fix	Invalid hreflang attribute value present
`hreflang/missing_self_reference`	seo	fix	Self-referencing hreflang not present
`hreflang/missing_specific_audience`	seo	fix	Hreflang implementation does not contain any hreflang attribute specifying a language and/or region
`hreflang/missing_x_default`	seo	fix	Hreflang attribute with x-default value is missing
`robot_directives/conflicting`	aeo, seo	critical	Valid robot directives give conflicting directives to search engines
`robot_directives/invalid`	aeo, seo	critical	Valid robot directives give conflicting directives to search engines
`robot_directives/unsupported`	aeo, seo	critical	Valid but unsupported robot directives to a search engine present
`lighthouse/performance`	aeo, seo	opportunity	Performance score is too low
`lighthouse/fcp`	aeo, seo	opportunity	First Contentful Paint takes too long
`lighthouse/lcp`	aeo, seo	opportunity	Largest Contentful Paint takes too long
`lighthouse/tti`	aeo, seo	opportunity	Time To Interactive takes too long
`lighthouse/si`	aeo, seo	opportunity	Speed Index is too high
`lighthouse/tbt`	aeo, seo	opportunity	Total Blocking Time is too long
`lighthouse/cls`	aeo, seo	opportunity	Cumulative Layout Shift is too large
`semantic_html/core_layout_missing`	aeo, seo	critical	Core semantic HTML structure is present
`semantic_html/multiple_main_elements`	aeo, seo	critical	Single <main> element is present
`js_rendering/title_changed`	aeo, seo	critical	Page title matches between raw HTML and rendered DOM
`js_rendering/canonical_changed`	aeo, seo	critical	Canonical link matches between raw HTML and rendered DOM
`js_rendering/h1_changed`	aeo, seo	critical	H1 heading matches between raw HTML and rendered DOM
`js_rendering/word_count_changed`	aeo, seo	fix	Main content word count matches between raw HTML and rendered DOM
`js_rendering/outgoing_links_changed`	aeo, seo	fix	Outgoing links match between raw HTML and rendered DOM
`schema_org/errors`	aeo, seo	fix	Schema.org implementation has an invalid structure
`schema_org/invalid_json`	aeo, seo	fix	Schema element with invalid JSON-LD object present
`schema_org/invalid_property`	aeo, seo	fix	All schema properties are valid for their declared types
`schema_org/invalid_property_value`	aeo, seo	fix	All schema property values have correct format
`schema_org/invalid_type`	aeo, seo	fix	All schema @type values are recognized
`schema_org/mandatory_schema_missing`	aeo, seo	critical	Required schema types are present
`schema_org/missing_required_property`	aeo, seo	fix	All required schema properties are present
`schema_org/missing_recommended_property`	aeo, seo	opportunity	All recommended schema properties are present

Retrieving historical data

Certain endpoints support retrieving historical data using the captured_at query parameter. The captured_at parameter is a timestamp indicating when the data was collected by Conductor Monitoring and supports the ISO-8601 datetime format. The captured_at parameter is supported by the following endpoints:

For example, to retrieve the statistics for a website from June 1st, 2022 at 05:00, you can send the following request:

GET /v2/data/statistics?website_id={website_id}&captured_at=2022-06-01T05:00:00+00:00

Data is golden

The is_data_golden property indicates whether the response to this request is golden or not.When the data is golden, it means that when the same request is made at a later point in time, the retrieved data will always be exactly the same.In context of Conductor Monitoring’s data, this applies to retrieving data historically. The historical data retrieved from Conductor Monitoring will always be golden as the data cannot change anymore, as opposed to retrieving current data which is subject to change.

Data Enrichment API

Conductor Intelligence's Legacy Reporting API

⌘I

​Getting Started

​Overview

​Important

​Reporting API Terms of Use

​Authentication

​Get your API integration token

​Configure your request headers

​Note!

​Rate limits

​Using the Conductor Monitoring Reporting API

​Base URL

​Retrieving a list of websites in your account

​/v2/entities/websites

​Request Body

​Responses

​Schema data types for this endpoint

​Retrieving a list of segments for a website

​/v2/entities/segments?website_id={website_id}

​Request Path Parameters

​Request Response

​Schema data types for this endpoint

​Retrieving statistics for a website or website’s segment

​/v2/data/statistics?website_id={website_id}

​Request Path Parameters

​Query Parameters

​Request Responses

​Schema data types for this endpoint

​Specific errors when requesting statistics

​Retrieving list of pages for a website

​/v2/data/pages

​Query Parameters

​Important

​Request Responses

​Schema data types for this endpoint

​Retrieving data for a specific page within a website

​/v2/data/page

​Query Parameters

​Response for a page

​Schema data types for this endpoint

​Retrieving log file data for a website

​/v2/data/page_lfa

​Query Parameters

​Request Responses

​Schema data types for this endpoint

​Retrieving list of alerts for a website

​/v2/alerts

​Query Parameters

​Request Responses

​Schema data types for this endpoint

​Retrieving list of pages for a website alert

​/v2/alerts/alert_pages

​Query Parameters

​Request Responses

​Schema data types for this endpoint

​Retrieving a list of issues for a website or segment

​/v2/data/issues

​Query Parameters

​Request Responses

​Schema data types for this endpoint

​Retrieving list of pages for a website issue

​/v2/data/affected_pages

​Query Parameters

​Request Responses

​Schema data types for this endpoint

​List of issues

​Retrieving historical data

​Data is golden

Getting Started

Overview

Important

Reporting API Terms of Use

Authentication

Get your API integration token

Configure your request headers

Note!

Rate limits

Using the Conductor Monitoring Reporting API

Base URL

Retrieving a list of websites in your account

/v2/entities/websites

Request Body

Responses

Schema data types for this endpoint

Retrieving a list of segments for a website

/v2/entities/segments?website_id={website_id}

Request Path Parameters

Request Response

Schema data types for this endpoint

Retrieving statistics for a website or website’s segment

/v2/data/statistics?website_id={website_id}

Request Path Parameters

Query Parameters

Request Responses

Schema data types for this endpoint

Specific errors when requesting statistics

Retrieving list of pages for a website

/v2/data/pages

Query Parameters

Important

Request Responses

Schema data types for this endpoint

Retrieving data for a specific page within a website

/v2/data/page

Query Parameters

Response for a page

Schema data types for this endpoint

Retrieving log file data for a website

/v2/data/page_lfa

Query Parameters

Request Responses

Schema data types for this endpoint

Retrieving list of alerts for a website

/v2/alerts

Query Parameters

Request Responses

Schema data types for this endpoint

Retrieving list of pages for a website alert

/v2/alerts/alert_pages

Query Parameters

Request Responses

Schema data types for this endpoint

Retrieving a list of issues for a website or segment

/v2/data/issues

Query Parameters

Request Responses

Schema data types for this endpoint

Retrieving list of pages for a website issue

/v2/data/affected_pages

Query Parameters

Request Responses

Schema data types for this endpoint

List of issues

Retrieving historical data

Data is golden