Temso Docs
API referenceSources

Get Source URL Analytics

Returns per-URL citation analytics over the date range — appearances, citation rate, average position, and the brands mentioned alongside each URL. Export-equivalent of the source URLs CSV.

GET
/projects/{projectId}/sources/urls

Returns per-URL citation analytics over the date range — appearances, citation rate, average position, and the brands mentioned alongside each URL. Export-equivalent of the source URLs CSV.

Path Parameters

projectId*string

Project ID (see List Projects)

Query Parameters

filter*
sort?string

Sort field (e.g. responseCount, avgPosition).

order?string

Sort order: asc or desc.

page?integer

Page number (1-indexed, default: 1)

Default1
Range1 <= value
limit?integer

Items per page (default: 50, max: 1000)

Default50
Range1 <= value <= 1000

Response Body

application/json

curl -X GET "https://example.com/projects/string/sources/urls?filter%5BstartDate%5D=2026-01-01&filter%5BendDate%5D=2026-03-19&filter%5Blanguages%5D=en%2Cde&filter%5Bcountries%5D=US%2CDE&filter%5Bmodels%5D=microsoft%2Fcopilot-search%2Cgoogle%2Fai-overview%2Cgoogle%2Fai-mode%2Cperplexity%2Fsearch%2Cgemini%2Fsearch%2Copenai%2Fchatgpt&filter%5BpromptTypes%5D=informational%2Cnavigational&filter%5BisBranded%5D=true&filter%5BpersonaIds%5D=string&filter%5BofferingIds%5D=string&filter%5BpromptTagIds%5D=string&filter%5BbrandIds%5D=string&filter%5BdomainContains%5D=string&filter%5BurlContains%5D=string&filter%5Btypes%5D=string"
{
  "data": [
    {
      "urlId": "string",
      "url": "string",
      "domain": "example.com",
      "title": "string",
      "type": "string",
      "responseCount": 0,
      "presence": 0,
      "citedCount": 0,
      "cited": 0,
      "avgPosition": 0,
      "urlRank": 0,
      "domainRank": 0,
      "models": [
        "string"
      ],
      "brandMentions": [
        "string"
      ],
      "firstSeen": "string",
      "lastSeen": "string"
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "total": 0
  }
}

List Sources GET

Returns one row per source citation from AI responses in the date range — the URLs models referenced when answering. Use it to analyze which domains and pages drive AI answers in your space.

Get Source Domain Analytics GET

Returns per-domain citation analytics over the date range — appearances, citation rate, URL counts, and the brands mentioned. Export-equivalent of the source domains CSV.