> ## Documentation Index > Fetch the complete documentation index at: https://www.conductor.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List pages for a website > Retrieve a paginated list of every tracked URL on a website, with full SEO metadata for each page. ## OpenAPI ````yaml other-apis/monitoring/openapi.json GET /v2/data/pages openapi: 3.0.3 info: title: Conductor Monitoring APIs description: >- Complete collection for all Conductor Monitoring APIs. ## The 3 API Tokens | Token Variable | API | Purpose | |---|---|---| | `reporting_api_token` | Reporting API v1 + v2 | READ — extract SEO data, stats, pages, issues, alerts | | `cms_api_token` | CMS API v1 | WRITE — trigger immediate page re-crawl after publishing | | `enrichment_api_token` | Data Enrichment API v1 | WRITE — push custom field values (revenue, owner, etc.) into pages | All tokens found under: ****Account** > **Account** tab > **Integration Tokens**** ## Rate Limits - Reporting API: 6 req/sec/IP (429 for 1 min if exceeded) - Data Enrichment API: max 1,000 URLs/request, 1 req/sec/website version: 1.0.0 servers: - url: https://api.cm.conductor.com security: [] tags: - name: Reporting API v2 - Entities description: |- Current version — use this for all new integrations. Token: reporting_api_token Purpose: Read-only SEO data extraction. - name: Reporting API v2 - Data description: |- Current version — use this for all new integrations. Token: reporting_api_token Purpose: Read-only SEO data extraction. - name: Reporting API v2 - Alerts description: |- Current version — use this for all new integrations. Token: reporting_api_token Purpose: Read-only SEO data extraction. - name: Reporting API v1 (Legacy) description: >- Original Reporting API — will be deprecated. Same reporting_api_token as v2. Key differences from v2: - website_id is a URL path segment, not a query param - Has /gds (Google Data Studio) and /metrics endpoints not in v2 - No LFA endpoint - Fewer response fields Migrate to v2 when possible. - name: CMS API v1 description: >- Trigger immediate re-crawls when content is published. Token: cms_api_token (separate from Reporting API) Typical use: call from CMS publish hooks (WordPress, Contentful, Drupal, etc.) - name: Data Enrichment API v1 description: >- Push custom data into Conductor Monitoring pages. Token: enrichment_api_token (separate from Reporting and CMS APIs) Use cases: revenue per page, page owner, qualified leads, content score, last reviewed date. Setup: 1. **Settings** > **Enrichment Fields** > **Create Enrichment Field** 2. Choose type: string, number, boolean, or date 3. Copy the Enrichment Field ID for use in requests Rate limits: max 1,000 URLs/request, 1 req/sec/website Once pushed, enrichment data can be used to: - Filter pages - Create segments - Set change alerts - View in page detail paths: /v2/data/pages: get: tags: - Reporting API v2 - Data summary: List Pages for a Website description: >- Paginated list of all tracked URLs with full SEO metadata. Pro tip: Use page_cursor for sites with 10k+ pages — it is faster and more reliable than the page parameter. parameters: - name: website_id in: query required: true description: Required. schema: type: string example: 1-234 - name: per_page in: query required: true description: >- Required. **Pagination control.** How many *results* to return per request, 1–1000. It counts result rows, not web pages on your site. schema: type: integer minimum: 1 maximum: 1000 example: 100 - name: page in: query required: false description: >- Optional on this endpoint. **Pagination control.** Which page of *results* to return, numbered from 1. It selects a slice of the result set and is unrelated to the web pages the endpoint returns. schema: type: integer example: 1 - name: page_cursor in: query required: false description: >- Optional. **Pagination control.** Cursor from `next_page_cursor` in the previous response. Faster and more reliable than `page` on large result sets, and it takes precedence over `page` — do not send both. schema: type: string - name: sort in: query required: false description: Optional. schema: type: string example: url - name: direction in: query required: false description: Optional. asc or desc. schema: type: string enum: - asc - desc example: asc responses: '200': description: Successful response. content: application/json: schema: type: object properties: data: type: object properties: next_page_cursor: type: string total: type: integer urls: type: array items: type: object properties: aa_average_time_spent_on_site: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Seconds. Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. aa_bounce_rate: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Percentage. Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. aa_page_views: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. aa_revenue: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. aa_unique_visitors: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. analytics_services: type: array items: type: string description: >- Documented as `string` in the Reporting API reference; sample responses return `array`. nullable: true app_url: type: string canonical: type: string nullable: true canonical_type: type: string custom_elements: oneOf: - type: object - type: array items: {} maxItems: 0 description: >- Map of Custom Element name to extracted value. Serialised as `[]` when empty. ga_average_time: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Seconds. Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_bounce_rate: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Percentage. Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_page_value: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_page_views: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_unique_page_views: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_v4_active_users: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_v4_average_engagement_time: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Seconds. Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_v4_engagement_rate: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Percentage. Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. ga_v4_screen_page_views: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. gsc_clicks: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. gsc_ctr: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Percentage. Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. gsc_impressions: oneOf: - type: integer - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. gsc_position: oneOf: - type: number - type: string enum: - no_data nullable: true description: >- Returns the string `"no_data"` when the connected analytics or Search Console integration has no value for this page. Check for it before doing arithmetic. h1: type: string nullable: true health: type: number nullable: true hreflang_language: type: string nullable: true is_disallowed_in_robots_txt: type: boolean is_https: type: boolean is_in_sitemap: type: boolean is_indexable: type: boolean is_indexable_due_to_meta_robots: oneOf: - type: boolean - type: string nullable: true description: >- Production returns a boolean on some websites and a string such as `"yes"` on others. Handle both. is_indexable_due_to_x_robots_tag: oneOf: - type: boolean - type: string nullable: true description: >- Production returns a boolean on some websites and a string such as `"yes"` on others. Handle both. is_linked: type: boolean lfa_bing_desktop_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_bing_desktop_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_bing_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_bing_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_bing_mobile_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_bing_mobile_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_google_desktop_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_google_desktop_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_google_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_google_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_google_mobile_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_google_mobile_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_openai_bot_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_openai_bot_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_openai_desktop_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_openai_desktop_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_openai_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_openai_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_openai_search_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_openai_search_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_openai_user_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_openai_user_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_perplexity_bot_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_perplexity_bot_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_perplexity_desktop_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_perplexity_desktop_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_perplexity_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_perplexity_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lfa_perplexity_user_frequency: type: object nullable: true description: Crawl frequency for this crawler. properties: value: type: number description: Visits per `unit`. unit: type: string description: Time unit, e.g. `month`. lfa_perplexity_user_last_visit: nullable: true description: Datetime (ISO-8601 format) type: string lighthouse_cls: type: object nullable: true description: Lighthouse metric with its banding. properties: value: type: number range: type: string enum: - good - needsImprovement - bad lighthouse_fcp: type: object nullable: true description: Lighthouse metric with its banding. properties: value: type: number range: type: string enum: - good - needsImprovement - bad lighthouse_lcp: type: object nullable: true description: Lighthouse metric with its banding. properties: value: type: number range: type: string enum: - good - needsImprovement - bad lighthouse_performance: type: object nullable: true description: Lighthouse metric with its banding. properties: value: type: number range: type: string enum: - good - needsImprovement - bad lighthouse_si: type: object nullable: true description: Lighthouse metric with its banding. properties: value: type: number range: type: string enum: - good - needsImprovement - bad lighthouse_tbt: type: object nullable: true description: Lighthouse metric with its banding. properties: value: type: number range: type: string enum: - good - needsImprovement - bad lighthouse_tti: type: object nullable: true description: Lighthouse metric with its banding. properties: value: type: number range: type: string enum: - good - needsImprovement - bad link_amp: nullable: true type: string format: uri link_next: nullable: true type: string format: uri link_prev: nullable: true type: string format: uri meta_description: type: string nullable: true mobile_variant: nullable: true type: string format: uri number_of_hreflangs: type: integer number_of_incoming_internal_canonicals: type: integer number_of_incoming_internal_links: type: integer number_of_incoming_internal_redirects: type: integer number_of_outgoing_external_links: type: integer nullable: true number_of_outgoing_internal_links: type: integer nullable: true open_graph_description: type: string nullable: true open_graph_image: type: string nullable: true open_graph_title: type: string nullable: true open_graph_type: type: string nullable: true open_graph_url: type: string nullable: true redirect: type: string nullable: true relevance: type: number nullable: true schema_org_number_of_types: type: integer nullable: true schema_org_types: type: array items: {} nullable: true segments: type: array items: {} status_code: type: integer tag_managers: type: array items: type: string nullable: true time_document_download: type: integer title: type: string nullable: true twitter_card: type: string nullable: true twitter_description: type: string nullable: true twitter_image: type: string nullable: true twitter_site: type: string nullable: true twitter_title: type: string nullable: true type: type: string url: type: string url_depth: type: integer url_path: type: string visual_analytics_services: type: array items: type: string nullable: true gsc_date_range: type: array items: type: object properties: since: type: string format: date until: type: string format: date legacy_id_fallback: type: string nullable: true url_id: type: string is_video: type: boolean video_duration: description: Float (seconds) type: string video_title: type: string webp: type: string format: uri watched_events: type: array items: type: object properties: watched_event_name: type: string data_captured_at: description: Datetime (ISO-8601 format) type: string is_data_golden: type: boolean data_captured_at: type: string is_data_golden: type: boolean examples: default: value: 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': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/Unprocessable' '429': $ref: '#/components/responses/RateLimited' security: - reportingApiToken: [] components: responses: Unauthorized: description: > Unauthorized. - **Missing authentication token** — the request was received but carries no authorization token, so it cannot be processed. Check that the `Authorization` header is set. - **Authentication failed** — the supplied API token is expired or invalid: ```json { "code": "auth_failed", "message": "Authentication token is expired or invalid.", "errors": [] } ``` content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: missingToken: value: code: auth_missing_token message: >- Authentication token must be passed in Authorization HTTP header. errors: [] Forbidden: description: > Forbidden. - **Terms of Use not accepted** — accept the Reporting API Terms of Use in Account Settings before calling the API. - **Blocked user agent** — our CDN blocks generic default user agents such as `Python urllib3`. Setting a less generic user agent, or one that more closely resembles a browser, usually bypasses this. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: termsNotAccepted: value: 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: [] NotFound: description: > Not found. The requested website, scope, or URL does not exist or is unavailable. - **Website not found** — the `website_id` does not belong to the account that owns the token. - **No statistics for scope** — statistics for the given website or segment are not available at this time. They may become available later, depending on the actual content of the scope: ```json { "error": "No statistics found for given scope" } ``` - **URL not found** — the requested URL is not tracked on this website: ```json { "error": "Requested URL was not found (url)" } ``` content: application/json: schema: $ref: '#/components/schemas/SimpleError' examples: websiteNotFound: value: error: Requested website ID was not found Unprocessable: description: >- Unprocessable entity. The `Authorization` header was not formatted correctly — the value must be the string `token`, a space, then your API token. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: authMalformed: value: code: auth_malformed message: >- Authorization HTTP header must conform to format described in docs. errors: [] RateLimited: description: >- Too many requests. The Reporting API allows 6 requests/second per requester IP address; exceeding it returns `429` for one minute. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: rateLimited: value: code: rate_limit_exceeded message: Too many requests. Try again in a minute. errors: [] schemas: ApiError: type: object description: Structured error payload returned by the Monitoring APIs. properties: code: type: string description: Machine-readable error code. message: type: string description: Human-readable explanation. errors: type: array description: Field-level details, when available. items: type: object SimpleError: type: object description: Short error payload used by the Reporting API for lookup failures. properties: error: type: string description: Human-readable explanation. securitySchemes: reportingApiToken: type: apiKey in: header name: Authorization description: >- Send your Reporting API token as `Authorization: token {reporting_api_token}` — the literal string `token`, a space, then the token itself. Find it in Conductor Monitoring under **Account** > **Account** tab > **Integration Tokens**. ````