> ## 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 log file analysis data

> Get daily search engine and AI crawler visit counts for up to 50 URLs at a time.



## OpenAPI

````yaml other-apis/monitoring/openapi.json GET /v2/data/page_lfa
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/page_lfa:
    get:
      tags:
        - Reporting API v2 - Data
      summary: Get Log File Analysis Data (LFA)
      description: >-
        Daily crawler visit counts per URL.


        Crawlers returned: lfa_anthropic_bot, lfa_anthropic_search,
        lfa_anthropic_user, lfa_bing_desktop, lfa_bing_mobile,
        lfa_google_desktop, lfa_google_mobile, lfa_meta_bot, lfa_meta_user,
        lfa_openai_bot, lfa_openai_search, lfa_openai_user, lfa_perplexity_bot,
        lfa_perplexity_user


        Requires Log File Analysis feature enabled. Max 50 URLs/request.
      parameters:
        - name: website_id
          in: query
          required: true
          description: Required.
          schema:
            type: string
          example: 1-234
        - name: urls[]
          in: query
          required: true
          description: Required. Repeat this param for each URL. Max 50.
          schema:
            type: array
            items:
              type: string
              format: uri
          style: form
          explode: true
          example:
            - https://www.example.com/
            - https://www.example.com/about-us/
        - name: date_range[start_date]
          in: query
          required: false
          description: >-
            Optional. YYYY-MM-DD. Both fields needed together. Default: last 30
            days.
          schema:
            type: string
            format: date
          example: '2025-08-01'
        - name: date_range[end_date]
          in: query
          required: false
          description: Optional. YYYY-MM-DD.
          schema:
            type: string
            format: date
          example: '2025-08-31'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      urls:
                        type: array
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                              format: uri
                            visits_per_day:
                              type: object
                              description: >-
                                Daily visit counts per crawler. Each crawler is
                                serialised as `[]` when it has no visits in the
                                range.
                              properties:
                                lfa_anthropic_bot:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_anthropic_search:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_anthropic_user:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_bing_desktop:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_bing_mobile:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_google_desktop:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_google_mobile:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_meta_bot:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_meta_user:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_openai_bot:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_openai_search:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_openai_user:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_perplexity_bot:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                                lfa_perplexity_user:
                                  description: Map of `YYYY-MM-DD` to visit count.
                                  oneOf:
                                    - type: object
                                      additionalProperties:
                                        type: integer
                                    - type: array
                                      items: {}
                                      maxItems: 0
                      url:
                        type: object
                        properties:
                          visits_per_day:
                            type: object
                            properties:
                              lfa_openai_search:
                                type: array
                                items:
                                  type: object
                                  additionalProperties:
                                    type: integer
                              lfa_openai_user:
                                type: array
                                items:
                                  type: object
                                  additionalProperties:
                                    type: integer
                              lfa_perplexity_bot:
                                type: array
                                items:
                                  type: object
                                  additionalProperties:
                                    type: integer
                              lfa_perplexity_user:
                                type: array
                                items:
                                  type: object
                                  additionalProperties:
                                    type: integer
                      data_captured_at:
                        description: Datetime (ISO-8601 format)
                        type: string
                  data_captured_at:
                    type: string
              examples:
                default:
                  value:
                    data:
                      urls:
                        - url: https://www.example.com/
                          visits_per_day:
                            lfa_bing_desktop:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_bing_mobile:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_google_desktop:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_google_mobile:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_openai_bot:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_openai_search:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_openai_user:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_perplexity_bot:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                            lfa_perplexity_user:
                              '2025-08-28': 2
                              '2025-08-29': 3
                              '2025-08-30': 2
                        - url: https://www.example.com/about-us/
                          visits_per_day:
                            lfa_bing_desktop:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_bing_mobile:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_google_desktop:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_google_mobile:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_openai_bot:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_openai_search:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_openai_user:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_perplexity_bot:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                            lfa_perplexity_user:
                              '2025-08-28': 0
                              '2025-08-29': 1
                              '2025-08-30': 0
                    data_captured_at: '2026-01-06T16:07:41+01:00'
        '400':
          $ref: '#/components/responses/LfaNotEnabled'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/LfaForbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - reportingApiToken: []
components:
  responses:
    LfaNotEnabled:
      description: >-
        Bad request. Log File Analysis is not enabled for this website in
        Conductor Monitoring.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SimpleError'
          examples:
            lfaNotEnabled:
              value:
                error: Log File Analysis is not enabled
    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: []
    LfaForbidden:
      description: >
        Forbidden.


        - **URL cannot be provided** — every requested URL must be one of these
        types: page, redirect, server error, or missing.

        - **Blocked user agent** — our CDN blocks generic default user agents
        such as `Python urllib3`. Setting a less generic user agent usually
        bypasses this.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SimpleError'
          examples:
            urlNotServable:
              value:
                error: Requested URL cannot be provided via Reporting API (url)
    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:
    SimpleError:
      type: object
      description: Short error payload used by the Reporting API for lookup failures.
      properties:
        error:
          type: string
          description: Human-readable explanation.
    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
  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**.

````