Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.topify.ai/llms.txt

Use this file to discover all available pages before exploring further.

Sources are the domains that AI providers cite when answering tracked prompts. This endpoint aggregates citation data at the domain level across all prompts in a project.

​
List sources

GET /projects/{project_id}/sources
Returns source domains with citation counts, paginated and sorted by reference_count descending.

​
Path parameters

ParamTypeDescription
project_idstring (UUID)The project ID

​
Query parameters

ParamTypeDefaultDescription
pageinteger1Page number (starts at 1)
page_sizeinteger50Results per page (min 1, max 100)
duration_daysinteger7Days to look back
date_fromstring—Start date (YYYY-MM-DD)
date_tostring—End date (YYYY-MM-DD)
providersstring—Comma-separated provider filter
curl "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/sources?page=1&page_size=50&duration_days=7" \
  -H "X-API-Key: tk_live_..."

​
Response

{
  "success": true,
  "data": [
    {
      "source_id": "s1t2u3v4-...",
      "domain": "techcrunch.com",
      "category": 1,
      "reference_count": 127
    },
    {
      "source_id": "w5x6y7z8-...",
      "domain": "forbes.com",
      "category": 1,
      "reference_count": 89
    }
  ]
}

​
SourceDomainResponse fields

FieldTypeNullableDescription
source_idstring (UUID)NoSource ID
domainstringNoDomain name
categoryintegerNoDomain category ID
reference_countintegerNoTotal citations across all prompts in the date range
The data field is a flat array (not wrapped in an object) for this endpoint. Pagination does not include a total count — fetch pages until an empty array is returned.