> ## 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 affected pages for an issue > List the pages affected by a specific SEO issue on a website. ## OpenAPI ````yaml other-apis/monitoring/openapi.json GET /v2/data/affected_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/affected_pages: get: tags: - Reporting API v2 - Data summary: List Affected Pages for an Issue description: >- Pages affected by a specific SEO issue. Common issue names: title/missing, title/duplicate, title/incorrect_length, title/too_many meta_description/missing, meta_description/duplicate, meta_description/incorrect_length h1/missing, h1/duplicate, h1/incorrect_length, h1/too_many canonical_link/missing, canonical_link/points_to_unindexable, canonical_link/too_many links/broken, links/redirected, links/to_canonicalized open_graph/image_missing, open_graph/title_missing, open_graph/description_missing xml_sitemap/incorrectly_missing, xml_sitemap/incorrectly_present lighthouse/performance, lighthouse/fcp, lighthouse/lcp, lighthouse/cls, lighthouse/tbt, lighthouse/tti, lighthouse/si hreflang/missing_self_reference, hreflang/missing_x_default, hreflang/invalid_value schema_org/errors, schema_org/invalid_json robot_directives/conflicting, robot_directives/invalid parameters: - name: website_id in: query required: true description: Required. schema: type: string example: 1-234 - name: issue in: query required: true description: Required. E.g. title/missing, links/broken, lighthouse/lcp schema: type: string example: title/missing - name: page in: query required: true description: >- Required. Omitting it returns `400 invalid_payload` naming the missing field. **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: per_page in: query required: true description: >- Required. Omitting it returns `400 invalid_payload` naming the missing field. **Pagination control.** How many *results* to return per request, 1–1000. It counts result rows, not web pages on your site. schema: type: integer example: 100 responses: '200': description: Successful response. content: application/json: schema: type: object properties: data: type: object properties: total: type: integer urls: type: array items: type: object properties: app_url: type: string format: uri relevance: type: number segments: type: array items: type: string url: type: string format: uri url_path: type: string path: type: string format: uri segments: type: array items: type: string description: Containing segment ids. data_captured_at: description: Datetime (ISO-8601 format) type: string is_data_golden: type: boolean Issue: description: Issue Tag type: string analytics/analytics_missing: description: Seo type: string analytics/visual_analytics_missing: description: Seo type: string h1/duplicate: description: Aeo, seo type: string h1/incorrect_length: description: Aeo, seo type: string h1/missing: description: Aeo, seo type: string h1/too_many: description: Aeo, seo type: string canonical_link/incorrectly_canonicalized: description: Aeo, seo type: string canonical_link/missing: description: Aeo, seo type: string canonical_link/points_to_unindexable: description: Aeo, seo type: string canonical_link/too_many: description: Aeo, seo type: string content_depth/html_size_too_big: description: Aeo, seo type: string content_depth/body_empty: description: Aeo, seo type: string content_depth/body_size_too_big: description: Aeo, seo type: string content_depth/body_size_too_small: description: Aeo, seo type: string content_depth/text_to_code_ratio: description: Aeo, seo type: string content_depth/rich_text_elements_are_missing: description: Aeo, seo type: string images/alt_attribute: description: Aeo, seo type: string links/broken: description: Aeo, seo type: string links/redirected: description: Aeo, seo type: string links/to_canonicalized: description: Aeo, seo type: string meta_description/duplicate: description: Aeo, seo type: string meta_description/incorrect_length: description: Aeo, seo type: string meta_description/missing: description: Aeo, seo type: string meta_description/too_many: description: Aeo, seo type: string title/duplicate: description: Aeo, seo type: string title/incorrect_length: description: Aeo, seo type: string title/missing: description: Aeo, seo type: string title/too_many: description: Aeo, seo type: string open_graph/description_incorrect_length: description: Seo type: string open_graph/description_missing: description: Seo type: string open_graph/image_missing: description: Seo type: string open_graph/title_incorrect_length: description: Seo type: string open_graph/title_missing: description: Seo type: string open_graph/url_missing: description: Seo type: string twitter_cards/description_incorrect_length: description: Seo type: string twitter_cards/description_missing: description: Seo type: string twitter_cards/image_missing: description: Seo type: string twitter_cards/site_missing: description: Seo type: string twitter_cards/title_incorrect_length: description: Seo type: string twitter_cards/title_missing: description: Seo type: string twitter_cards/type_invalid: description: Seo type: string twitter_cards/type_missing: description: Seo type: string xml_sitemap/incorrectly_missing: description: Aeo, seo type: string xml_sitemap/incorrectly_present: description: Aeo, seo type: string hreflang/conflicting_targets: description: Seo type: string hreflang/invalid_target: description: Seo type: string hreflang/invalid_value: description: Seo type: string hreflang/missing_self_reference: description: Seo type: string hreflang/missing_specific_audience: description: Seo type: string hreflang/missing_x_default: description: Seo type: string robot_directives/conflicting: description: Aeo, seo type: string robot_directives/invalid: description: Aeo, seo type: string robot_directives/unsupported: description: Aeo, seo type: string lighthouse/performance: description: Aeo, seo type: string lighthouse/fcp: description: Aeo, seo type: string lighthouse/lcp: description: Aeo, seo type: string lighthouse/tti: description: Aeo, seo type: string lighthouse/si: description: Aeo, seo type: string lighthouse/tbt: description: Aeo, seo type: string lighthouse/cls: description: Aeo, seo type: string semantic_html/core_layout_missing: description: Aeo, seo type: string semantic_html/multiple_main_elements: description: Aeo, seo type: string js_rendering/title_changed: description: Aeo, seo type: string js_rendering/canonical_changed: description: Aeo, seo type: string js_rendering/h1_changed: description: Aeo, seo type: string js_rendering/word_count_changed: description: Aeo, seo type: string js_rendering/outgoing_links_changed: description: Aeo, seo type: string schema_org/errors: description: Aeo, seo type: string schema_org/invalid_json: description: Aeo, seo type: string schema_org/invalid_property: description: Aeo, seo type: string schema_org/invalid_property_value: description: Aeo, seo type: string schema_org/invalid_type: description: Aeo, seo type: string schema_org/mandatory_schema_missing: description: Aeo, seo type: string schema_org/missing_required_property: description: Aeo, seo type: string schema_org/missing_recommended_property: description: Aeo, seo type: string data_captured_at: type: string is_data_golden: type: boolean examples: default: value: 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 '400': $ref: '#/components/responses/InvalidPayload' '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: InvalidPayload: description: Bad request. A required parameter is missing or malformed. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: missingPage: value: code: invalid_payload message: Invalid data sent. errors: - message: Value is missing required fields missing_fields: - page 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**. ````