Source Domain Evolution

Track how a source’s citation metrics change over time

GET /api/v1/brands/{brandId}/source-domains/{sourceId}/evolution

Source Domain Evolution

cURL

curl --request GET \
  --url https://api.example.com/api/v1/brands/{brandId}/source-domains/{sourceId}/evolution

Track how a source’s citation metrics change over time. Returns daily time-series data for mentions and average position.

Path Parameters

brandId · string · required

The unique identifier of the brand

sourceId · string · required

The unique identifier of the source

Query Parameters

period · number

Number of days to include. If not specified, returns all data.

startDate · string

Start date (ISO 8601 format)

endDate · string

End date (ISO 8601 format)

provider · string

Filter by AI provider. Supports comma-separated multi-select (e.g., chatgpt,claude).

topic · string

Filter by topic ID. Supports comma-separated multi-select (e.g., id1,id2).

tag · string

Filter by tag ID. Supports comma-separated multi-select (e.g., id1,id2).

Example Request

curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/source-domains/src1/evolution?period=7" \
  -H "Authorization: Bearer qw-api-your-token-here"

Example Response

{
  "success": true,
  "source": {
    "id": "src1",
    "domain": "industry-news.com",
    "isSelf": false
  },
  "evolution": [
    {
      "date": "2024-12-01",
      "mentions": 5,
      "avgPosition": 3.1
    },
    {
      "date": "2024-12-02",
      "mentions": 8,
      "avgPosition": 2.9
    }
  ]
}

Error Responses

Status	Code	Description
401	INVALID_TOKEN	Authentication failed
404	BRAND_NOT_FOUND	Brand doesn’t exist or not accessible
404	SOURCE_NOT_FOUND	Source doesn’t exist