Sources

The Sources API returns the AI-cited domains and URLs analyzed throughout a project. It is part of citation analysis of SE Visible where prompts and AI results tell you what AI engines said, and sources tell you which web pages they pulled the information from. Use it to identify the domains and pages that drive your AI visibility, see how often they appear in AI answers, and track whether they mention your brand or your competitors’ brands.

Using the SE Visible API, you can:

• list the domains AI models cite for a project, with appearance counts, coverage, and prompt reach
• drill into the individual URLs behind those domains, with page title, category, and HTTP status
• filter sources by model, country, topic, prompt, sentiment, brand mentions, and competitor presence
• compare a selected metric across two different date ranges to analyze performance changes

All endpoints are relative to the base URL https://api.seranking.com/v1/se-visible.

Get project sources

GET https://api.seranking.com/v1/se-visible/projects/{project_id}/sources

Retrieves the sources (domains or URLs) that AI models cited across a project, with extensive filtering. The shape of each row in the response depends on source_type: domain returns one row per cited domain, url returns one row per cited page.

Note:

• source_type switches the response between domain rows and URL rows. It also changes which source_sort_field values are valid: passing a sort field that belongs to the other type returns 422.
• Most numeric fields are wrapped in a metric object with a values array. A single period returns one entry in values. When you supply date_range[1] (compare mode), the field returns two entries plus a delta with absolute and percentage.

Request parameters

Path parameters

Query parameters

Request example

curl -X GET --globoff 'https://api.seranking.com/v1/se-visible/projects/550e8400-e29b-41d4-a716-446655440000/sources?source_type=domain&date_range[0][from]=2026-05-01&date_range[0][to]=2026-05-31&source_sort_field=ai_answers_count&sort_order=desc' \
  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns a sources object with the row list and a total count.

Most numeric fields are returned as a metric object rather than a plain number:

Domain rows (source_type=domain)

URL rows (source_type=url)

Response example

Domain sources, single period

{
  "items": [
    {
      "domain": "example.com",
      "domain_id": 123,
      "ai_answers_count": {
        "values": [45]
      },
      "pages": {
        "values": [12]
      },
      "coverage": {
        "values": [75.5]
      },
      "brand_ids": [1, 2],
      "competitors_count": {
        "values": [2]
      },
      "prompts_count": {
        "values": [10]
      },
      "my_brand_mentions_count": {
        "values": [3]
      },
      "mention_rate": {
        "values": [25]
      },
      "responses_count": {
        "values": [60]
      },
      "first_seen": "2024-01-01 00:00:00",
      "last_seen": "2024-01-15 00:00:00"
    }
  ],
  "total": 1
}

URL sources, compare mode

{
  "items": [
    {
      "url": "https://example.com/article1",
      "domain_id": 123,
      "ai_answers_count": {
        "values": [15, 8],
        "delta": {
          "absolute": 7,
          "percentage": 87.5
        }
      },
      "coverage": {
        "values": [25.5, 16],
        "delta": {
          "absolute": 9.5,
          "percentage": 59.38
        }
      },
      "type": "blog",
      "title": "Article 1",
      "brand_ids": [1, 2],
      "competitors_count": 2,
      "my_brand_mentions": 1,
      "gap_score": null,
      "prompts_count": {
        "values": [5, 3],
        "delta": {
          "absolute": 2,
          "percentage": 66.67
        }
      },
      "responses_count": {
        "values": [60, 50],
        "delta": {
          "absolute": 10,
          "percentage": 20
        }
      },
      "first_seen": "2024-01-01 00:00:00",
      "last_seen": "2024-02-15 00:00:00",
      "last_check_date": "2024-02-15 00:00:00",
      "status": 200
    }
  ],
  "total": 1
}