Query content

Query the tracked-content library across platforms with filters, sorting, and pagination.

GET/v1/discover/content

Authorization

bearerAuth

AuthorizationBearer <token>

API token issued from the dashboard (Settings → API Tokens). Sent as Authorization: Bearer <token>.

In: header

Query Parameters

platform?string

Social platform identifier. X (Twitter) is x. github tracks a repo (owner/repo) or owner (owner) — watched free (daily stars + releases), no paid scrape.

creatorId?string

Match

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Formatuuid

type?string

Value in"post" | "video"

search?string

Matches title and caption.

startDate?string

endDate?string

minViews?integer

Range0 <= value <= 9007199254740991

maxViews?integer

Range0 <= value <= 9007199254740991

minLikes?integer

Range0 <= value <= 9007199254740991

minComments?integer

Range0 <= value <= 9007199254740991

minEngagement?number

Range0 <= value

sortBy?string

Default"publishedAt"

sortOrder?string

Default"desc"

Value in"asc" | "desc"

limit?integer

Default50

Range1 <= value <= 200

offset?integer

Default0

Range0 <= value <= 9007199254740991

Response Body

`application/json`

cURL

curl -X GET "https://example.com/discover/content"

{
  "success": true,
  "content": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "creatorId": "688ebf54-d343-4104-8711-82c2feac534a",
      "platform": "string",
      "type": "string",
      "externalId": "string",
      "title": "string",
      "caption": "string",
      "mediaUrl": "string",
      "thumbnailUrl": "string",
      "hostedUrl": "string",
      "duration": -9007199254740991,
      "views": -9007199254740991,
      "likes": -9007199254740991,
      "comments": -9007199254740991,
      "shares": -9007199254740991,
      "engagementRate": 0,
      "outlierMultiplier": 0,
      "hashtags": [
        "string"
      ],
      "mentions": [
        "string"
      ],
      "publishedAt": "2019-08-24T14:15:22Z",
      "scrapedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "limit": -9007199254740991,
    "offset": -9007199254740991,
    "hasMore": true,
    "total": -9007199254740991
  }
}

{
  "error": "unauthorized"
}

Authorization

Query Parameters

Response Body

200application/json

401application/json

`application/json`

`application/json`