Skip to main content
GET
/
projects
/
{projectId}
/
citations
/
stats
Get citation statistics
curl --request GET \
  --url https://devtune.ai/api/v2/projects/{projectId}/citations/stats \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "citations": [
      {
        "url": "<string>",
        "domain": "<string>",
        "title": "<string>",
        "classification": "<string>",
        "sourceVertical": "<string>",
        "contentType": "<string>",
        "count": 123,
        "avgPosition": 123,
        "top3Count": 123
      }
    ],
    "pagination": {
      "page": 123,
      "pageSize": 123,
      "totalCount": 123,
      "totalPages": 123
    }
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

Authorizations

​
Authorization
string
header
required

API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.

Path Parameters

​
projectId
string<uuid>
required

Query Parameters

​
timeWindowDays
integer
​
page
integer
default:1
​
pageSize
integer
default:25
Required range: x <= 100
​
search
string
​
sortBy
string
​
sortDir
enum<string>
default:desc
Available options:
asc,
desc
​
classifications
enum<string>[]

Citation classifications to include, sent as a comma-separated list such as primary,competitor.

Maximum array length: 3
Available options:
primary,
competitor,
other

Response

Citation statistics

​
data
object
​
meta
object