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

# Get site references for a job

> Returns site previews for primary domain and competitor domains (order: primary first, then competitors).
Used by the References tab. Items may be null if not yet scraped. Requires access to the job (owner or demo). Use session or API key (Bearer).




## OpenAPI

````yaml openapi.json get /api/v1/jobs/{jobId}/references
openapi: 3.1.0
info:
  title: SuprKeywords API
  version: 0.1.0
  description: >-
    API for keyword research jobs: create jobs, list results, fetch personas,
    keywords, clusters, and export CSV. Programmatic access is authenticated
    with API keys (Authorization: Bearer <key>). The dashboard uses session
    cookies when using the web app in a browser.
  contact:
    name: SuprKeywords Support
    url: https://www.suprkeywords.com
    email: support@suprkeywords.com
servers:
  - url: https://www.suprkeywords.com
    description: Production
  - url: http://localhost:4605
    description: Local (for testing against a local API)
security:
  - bearerAuth: []
  - SessionAuth: []
tags: []
paths:
  /api/v1/jobs/{jobId}/references:
    get:
      tags:
        - Jobs
      summary: Get site references for a job
      description: >
        Returns site previews for primary domain and competitor domains (order:
        primary first, then competitors).

        Used by the References tab. Items may be null if not yet scraped.
        Requires access to the job (owner or demo). Use session or API key
        (Bearer).
      parameters:
        - in: path
          name: jobId
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: List of reference site previews
          content:
            application/json:
              schema:
                type: object
                properties:
                  references:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        title:
                          type: string
                          nullable: true
                        description:
                          type: string
                          nullable: true
                        imageUrl:
                          type: string
                          nullable: true
                        link:
                          type: string
        '404':
          description: Job not found or access denied
        '500':
          description: Internal server error
      security:
        - bearerAuth: []
        - SessionAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: >-
        API key for programmatic access. Create keys in Settings (Agency plan).
        Send as Authorization: Bearer <your-api-key> or X-API-KEY:
        <your-api-key>. Unauthenticated requests return 401.
    SessionAuth:
      type: apiKey
      in: cookie
      name: __session
      description: >-
        Session cookie when using the dashboard in a browser. For scripts and
        server-to-server calls, use BearerAuth (API key) instead. Demo job
        access is allowed for GET job and sub-resources when applicable.

````