> ## Documentation Index
> Fetch the complete documentation index at: https://radarkit.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List sources

> One row per web page an answer cited or consulted. `cited: true` means the page was linked in the answer and `cite_rank` is its number. `cited: false` means the model read it but did not link it.

Use it: to see the exact pages behind a domain, for example after Top source domains.

Cost: 1 API credit per page.

Limits: Up to 31 days in one call. Up to 100 rows per page.

Needs: Read.




## OpenAPI

````yaml /openapi.yaml get /projects/{project}/sources
openapi: 3.1.0
info:
  title: Radarkit API
  version: 1.0.0
  summary: Your AI visibility data, outside the dashboard.
  description: >
    Radarkit tracks how AI assistants answer the questions your customers ask,
    and what each answer says about your brand. This API gives you that data as
    JSON.


    Every request needs an API key in the `Authorization` header. Every response
    has the same shape: `data`, `meta`, `credits` and `request_id`. Most calls
    cost 1 API credit. Heavier calls cost 2. Exports spend Export rows instead,
    one per row.
  contact:
    name: Radarkit support
    email: mail@radarkit.ai
    url: https://radarkit.ai
servers:
  - url: https://api.radarkit.ai/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Your key, your plan and both balances. Free.
  - name: Projects
    description: One project is one brand or website. Every other call needs a project id.
  - name: Topics
    description: Topics group prompts. Every prompt belongs to one topic.
  - name: Prompts
    description: The questions Radarkit asks every AI model on a schedule.
  - name: Visibility
    description: The daily visibility score per model, precomputed.
  - name: Responses
    description: One row per AI answer, with everything Radarkit found in it.
  - name: Sources
    description: The web pages AI answers cite or consult.
  - name: Competitors
    description: Who the answers recommend and how often.
  - name: Rankings
    description: Recommended domains with their position in the answer.
  - name: Query fanout
    description: The web searches a model ran before answering, one row per answer.
  - name: Web search
    description: How often the models searched and what they searched for, summarised.
  - name: Sentiment
    description: How the answers talk about your brand.
  - name: Exports
    description: >
      Thousands of rows as one gzip file. Four calls in order: estimate, create,
      poll, download.


      Estimate is free and returns the exact row count. Create charges that many
      Export rows and queues the job. Poll the export until its status is
      `ready`. Download follows a redirect to a signed link that works for 30
      minutes. Files are kept for 7 days.
  - name: Content
    description: Have the Content agent write an article for a prompt, then poll the run.
paths:
  /projects/{project}/sources:
    get:
      tags:
        - Sources
      summary: List sources
      description: >
        One row per web page an answer cited or consulted. `cited: true` means
        the page was linked in the answer and `cite_rank` is its number. `cited:
        false` means the model read it but did not link it.


        Use it: to see the exact pages behind a domain, for example after Top
        source domains.


        Cost: 1 API credit per page.


        Limits: Up to 31 days in one call. Up to 100 rows per page.


        Needs: Read.
      operationId: listSources
      parameters:
        - $ref: '#/components/parameters/project'
        - $ref: '#/components/parameters/from'
        - $ref: '#/components/parameters/to'
        - $ref: '#/components/parameters/model'
        - $ref: '#/components/parameters/prompt_id'
        - name: domain
          in: query
          description: Only pages on this domain, exactly as stored.
          schema:
            type: string
            maxLength: 255
        - name: cited
          in: query
          description: >-
            `true` for pages linked in the answer, `false` for pages only
            consulted.
          schema:
            type: boolean
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/cursor'
      responses:
        '200':
          description: One page of sources.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Source'
                  meta:
                    $ref: '#/components/schemas/PageMeta'
                  credits:
                    $ref: '#/components/schemas/Credits'
                  request_id:
                    $ref: '#/components/schemas/RequestId'
              example:
                data:
                  - id: 5512001
                    prompt:
                      id: 2048
                      text: best crm for a startup
                    model: chatgpt
                    date: '2026-08-31'
                    collected_at: '2026-08-31T03:12:40+00:00'
                    url: https://www.g2.com/categories/crm
                    domain: g2.com
                    cited: true
                    cite_rank: 1
                meta:
                  project: 64f1a2b3c4d5e6f708192a3b
                  from: '2026-08-01'
                  to: '2026-08-31'
                  models:
                    - chatgpt
                  prompt_id: null
                  domain: g2.com
                  cited: true
                  limit: 50
                  count: 1
                  has_more: false
                  next_cursor: null
                credits:
                  charged: 1
                  remaining: 2942
                request_id: req_01j9x4v9l0m1n2o3p4q5r6s7u0
        '400':
          $ref: '#/components/responses/BadWindow'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/ProjectNotFound'
        '422':
          $ref: '#/components/responses/ValidationFailed'
        '429':
          $ref: '#/components/responses/RateLimited'
        '504':
          $ref: '#/components/responses/QueryTimeout'
components:
  parameters:
    project:
      name: project
      in: path
      required: true
      description: The project id. 24 characters. From List projects.
      schema:
        type: string
        pattern: ^[0-9a-f]{24}$
      example: 64f1a2b3c4d5e6f708192a3b
    from:
      name: from
      in: query
      description: >-
        First day, `YYYY-MM-DD`, in the project's timezone. Default: the window
        your dashboard shows, 7 or 30 days back.
      schema:
        type: string
        format: date
      example: '2026-08-01'
    to:
      name: to
      in: query
      description: 'Last day, `YYYY-MM-DD`, included. Default: today.'
      schema:
        type: string
        format: date
      example: '2026-08-31'
    model:
      name: model
      in: query
      description: >-
        One model name, or several separated by commas: `chatgpt`, `gemini`,
        `perplexity`, `copilot`, `aimode`, `aioverview`. Default: every model
        the project tracks. Names the plan does not include are ignored.
      schema:
        type: string
        maxLength: 120
      example: chatgpt,gemini
    prompt_id:
      name: prompt_id
      in: query
      description: Only rows for this prompt.
      schema:
        type: integer
        minimum: 1
    limit:
      name: limit
      in: query
      description: Rows per page, 1 to 100. Default 50.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 50
    cursor:
      name: cursor
      in: query
      description: '`next_cursor` from the previous page. Keep the other filters the same.'
      schema:
        type: string
        maxLength: 200
  schemas:
    Source:
      type: object
      properties:
        id:
          type: integer
        prompt:
          type: object
          properties:
            id:
              type: integer
            text:
              type:
                - string
                - 'null'
        model:
          type: string
        date:
          type: string
          format: date
        collected_at:
          type: string
          format: date-time
        url:
          type: string
        domain:
          type:
            - string
            - 'null'
        cited:
          type:
            - boolean
            - 'null'
          description: True when the page was linked in the answer.
        cite_rank:
          type:
            - integer
            - 'null'
          description: The citation number in the answer.
    PageMeta:
      type: object
      description: Facts about the request and how to get the next page.
      properties:
        project:
          type: string
        from:
          type: string
          format: date
        to:
          type: string
          format: date
        models:
          type: array
          items:
            type: string
        limit:
          type: integer
        count:
          type: integer
          description: Rows on this page.
        has_more:
          type: boolean
        next_cursor:
          type:
            - string
            - 'null'
          description: Send back as `cursor` to get the next page.
    Credits:
      type: object
      description: >-
        What this call cost and what is left. Also in the
        `X-RadarKit-Credits-Charged` and `X-RadarKit-Credits-Remaining` headers.
      properties:
        charged:
          type: integer
          description: API credits spent on this call.
        remaining:
          type:
            - integer
            - 'null'
          description: API credits left on the billed account. Null on free calls.
    RequestId:
      type: string
      description: >-
        A unique id for this call. Also in the `X-Request-Id` header. Quote it
        when you contact support.
      example: req_01j9x4m2p7q8r9s0t1u2v3w4x5
    Error:
      type: object
      description: Every failed call has this shape and no `data`.
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Stable. Build on this, not on the message.
            message:
              type: string
              description: For people. May change.
            details:
              description: >-
                More when there is more to say. Which field failed, how long to
                wait, which id already exists.
              oneOf:
                - type: object
                - type: array
                  items:
                    type: object
        request_id:
          $ref: '#/components/schemas/RequestId'
  responses:
    BadWindow:
      description: >-
        `DATE_RANGE_TOO_LARGE`: more than 31 days, use an export.
        `INVALID_CURSOR`: the cursor does not match these filters, start from
        the first page.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: DATE_RANGE_TOO_LARGE
              message: The date range can span at most 31 days. Use exports for more.
              details:
                max_days: 31
            request_id: req_01j9x4s6b7c8d9e0f1g2h3i4j6
    Unauthenticated:
      description: >-
        `UNAUTHENTICATED`: no key, a wrong key, or a revoked or expired key.
        `KEY_IN_QUERY` (400) if the key was in the URL.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: UNAUTHENTICATED
              message: >-
                Missing or invalid API key. Send it as: Authorization: Bearer
                rk_live_YOUR_KEY
            request_id: req_01j9x4q7z8y9x0w1v2u3t4s5r6
    PaymentRequired:
      description: >-
        `INSUFFICIENT_CREDITS`: no API credits left, nothing ran.
        `PLAN_INACTIVE`: the key owner's plan is not active.
        `OWNER_PLAN_INACTIVE`: the project owner's plan is not active.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INSUFFICIENT_CREDITS
              message: Not enough API credits.
            request_id: req_01j9x4q7z8y9x0w1v2u3t4s5r7
    Forbidden:
      description: >-
        `SCOPE_MISSING`: the key lacks the permission this call needs.
        `PROJECT_FORBIDDEN`: the key cannot reach this project. `API_FROZEN`:
        API access for the account is paused.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: PROJECT_FORBIDDEN
              message: This key cannot access that project.
            request_id: req_01j9x4q7z8y9x0w1v2u3t4s5r9
    ProjectNotFound:
      description: '`PROJECT_NOT_FOUND`: no project with that id.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: PROJECT_NOT_FOUND
              message: No project with that id.
            request_id: req_01j9x4q7z8y9x0w1v2u3t4s5s0
    ValidationFailed:
      description: >-
        `VALIDATION_FAILED`: a parameter is missing or wrong. `details` lists
        each field.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: VALIDATION_FAILED
              message: One or more parameters are invalid.
              details:
                - path: from
                  message: The from field must match the format Y-m-d.
            request_id: req_01j9x4s6b7c8d9e0f1g2h3i4j5
    RateLimited:
      description: >-
        `RATE_LIMITED`: too many calls. Wait the seconds in `Retry-After` and
        send the same request again. Nothing was charged.
      headers:
        Retry-After:
          description: Seconds to wait.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: RATE_LIMITED
              message: Too many requests. Slow down and retry.
              details:
                retry_after: 21
            request_id: req_01j9x4r2s3t4u5v6w7x8y9z0a1
    QueryTimeout:
      description: >-
        `QUERY_TIMEOUT`: the query took too long. Nothing was charged. Narrow
        the range or create an export.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: QUERY_TIMEOUT
              message: The query took too long. Narrow the date range or use exports.
            request_id: req_01j9x4r2s3t4u5v6w7x8y9z0a2
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your API key. Create one in Settings, API keys. Send it as
        `Authorization: Bearer rk_live_YOUR_KEY`.

````