> ## 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. # Get statistics > Get aggregate statistics for a website or segment: health score, issue counts, URL types, title, meta and H1 distributions, Lighthouse scores, and indexability. ## OpenAPI ````yaml other-apis/monitoring/openapi.json GET /v2/data/statistics 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/statistics: get: tags: - Reporting API v2 - Data summary: Get Statistics description: >- Aggregate stats: health score, issue count, URL types, title/meta/H1 distributions, Lighthouse scores, indexability, etc. Scope can target the whole website, a segment by ID, or a segment by label. parameters: - name: website_id in: query required: true description: Required. schema: type: string example: 1-234 - name: scope in: query required: true description: Required. website | segment:{id} | segment_label:{label} schema: type: string examples: website: value: website segmentById: value: segment:1 segmentByLabel: value: segment_label:Important pages - name: captured_at in: query required: false description: Optional. ISO-8601 for historical data. schema: type: string format: date-time example: '2022-06-01T05:00:00+00:00' responses: '200': description: Successful response. content: application/json: schema: type: object properties: data: type: object properties: health: type: integer nullable: true number_of_issues: type: integer number_of_urls: type: object properties: missing: type: integer page: type: integer redirect: type: integer server_error: type: integer unreachable: type: integer number_of_urls_per_property: type: object properties: h1: type: object properties: available: type: integer empty: type: integer missing: type: integer health: type: object properties: 0-100: type: integer 100-200: type: integer 200-300: type: integer 300-400: type: integer 400-500: type: integer 500-600: type: integer 600-700: type: integer 700-800: type: integer 800-900: type: integer 900-1000: type: integer hreflang_language: type: object properties: en: type: integer missing: type: integer others: type: integer is_disallowed_in_robots_txt: type: object properties: 'true': type: integer 'false': type: integer is_in_sitemap: type: object properties: 'true': type: integer 'false': type: integer is_indexable: type: object properties: 'true': type: integer 'false': type: integer is_indexable_due_to_meta_robots: type: object properties: 'no': type: integer not_applicable: type: integer 'yes': type: integer is_indexable_due_to_x_robots_tag: type: object properties: 'no': type: integer not_applicable: type: integer 'yes': type: integer is_linked: type: object properties: 'true': type: integer 'false': type: integer meta_description: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_description: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_image: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_title: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_type: type: object properties: empty: type: integer missing: type: integer others: type: integer values: oneOf: - type: object additionalProperties: type: integer - type: array items: {} maxItems: 0 description: >- Map of each observed value to its URL count. Serialised as `[]` when empty. open_graph_url: type: object properties: available: type: integer empty: type: integer missing: type: integer importance: type: object properties: 0-1: type: integer 1-2: type: integer 2-3: type: integer 3-4: type: integer 4-5: type: integer 5-6: type: integer 6-7: type: integer 7-8: type: integer 8-9: type: integer 9-10: type: integer status_code: type: object additionalProperties: type: integer description: Map of each observed status code to its URL count. title: type: object properties: available: type: integer empty: type: integer missing: type: integer twitter_card: type: object properties: empty: type: integer missing: type: integer others: type: integer values: oneOf: - type: object additionalProperties: type: integer - type: array items: {} maxItems: 0 description: >- Map of each observed value to its URL count. Serialised as `[]` when empty. twitter_description: type: object properties: available: type: integer empty: type: integer missing: type: integer twitter_image: type: object properties: available: type: integer empty: type: integer missing: type: integer twitter_site: type: object properties: empty: type: integer missing: type: integer others: type: integer values: oneOf: - type: object additionalProperties: type: integer - type: array items: {} maxItems: 0 description: >- Map of each observed value to its URL count. Serialised as `[]` when empty. twitter_title: type: object properties: available: type: integer empty: type: integer missing: type: integer is_https: type: object properties: 'true': type: integer 'false': type: integer url_depth: type: object properties: '0': type: integer '1': type: integer '2': type: integer '3': type: integer '4': type: integer '5': type: integer '6': type: integer '7': type: integer '8': type: integer '9': type: integer 10+: type: integer domain: type: object additionalProperties: type: integer description: Map of each observed domain to its URL count. lighthouse_cls: type: object properties: good: type: integer needsImprovement: type: integer bad: type: integer lighthouse_fcp: type: object properties: good: type: integer needsImprovement: type: integer bad: type: integer lighthouse_lcp: type: object properties: good: type: integer needsImprovement: type: integer bad: type: integer lighthouse_performance: type: object properties: good: type: integer needsImprovement: type: integer bad: type: integer lighthouse_si: type: object properties: good: type: integer needsImprovement: type: integer bad: type: integer lighthouse_tbt: type: object properties: good: type: integer needsImprovement: type: integer bad: type: integer lighthouse_tti: type: object properties: good: type: integer needsImprovement: type: integer bad: type: integer h1: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer hreflang_language: type: array items: type: object properties: hreflang_attribute: type: string missing: type: integer other: type: integer is_disallowed_in_robots_txt: type: array items: type: object properties: 'true': type: integer 'false': type: integer is_in_sitemap: type: array items: type: object properties: 'true': type: integer 'false': type: integer is_indexable: type: array items: type: object properties: 'true': type: integer 'false': type: integer is_indexable_due_to_meta_robots: type: array items: type: object properties: 'no': type: integer not_applicable: type: integer 'yes': type: integer is_indexable_due_to_x_robots_tag: type: array items: type: object properties: 'no': type: integer is_linked: type: array items: type: object properties: 'true': type: integer 'false': type: integer meta_description: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_description: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_image: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_title: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer open_graph_type: type: array items: type: object properties: empty: type: integer missing: type: integer others: type: integer values: type: array items: type: object properties: name: type: integer open_graph_URL: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer importance: type: array items: type: object properties: 0-1: type: integer 1-2: type: integer 2-3: type: integer 3-4: type: integer 4-5: type: integer 6-7: type: integer 8-9: type: integer 9-10: type: integer status_code: type: array items: type: object properties: value: type: integer title: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer twitter_card: type: array items: type: object properties: empty: type: integer missing: type: integer others: type: integer values: type: array values_name: type: integer twitter_description: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer twitter_image: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer twitter_site: type: array items: type: object properties: empty: type: integer missing: type: integer others: type: integer values: type: array items: type: object properties: name: type: integer twitter_title: type: array items: type: object properties: available: type: integer empty: type: integer missing: type: integer is_https: type: array items: type: object properties: 'true': type: boolean 'false': type: boolean url_depth: type: array items: type: object properties: '0': type: integer '1': type: integer '2': type: integer '3': type: integer '4': type: integer '6': type: integer '7': type: integer '8': type: integer '9': type: integer 10+: type: integer domain: type: array domain_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: 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': $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**. ````