Skip to main content
GET
/
projects
/
{projectId}
/
competitive
/
position
Get competitive positioning data
curl --request GET \
  --url https://devtune.ai/api/v2/projects/{projectId}/competitive/position \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "timeSeries": [
      {
        "date": "2023-12-25",
        "primaryCitations": 123,
        "competitorCitations": 123,
        "otherCitations": 123
      }
    ],
    "totals": {
      "primaryCitations": 123,
      "competitorCitations": 123,
      "otherCitations": 123,
      "total": 123,
      "primaryShare": 50
    }
  },
  "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

dateFrom
string<date>
dateTo
string<date>
platform
string
topicId
string<uuid>
grouping
enum<string>
default:daily
Available options:
daily,
weekly,
monthly

Response

Competitive positioning data

data
object
meta
object