Ask your research

Retrieval-grounded Q&A over your tracked creators' indexed content, with citations.

POST/v1/discover/ask

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

question*string

Length1 <= length <= 2000

platform?string

Restrict retrieval to one platform’s content.

creatorIds?array<>

Restrict retrieval to specific creators. Absent = every indexed creator.

Items1 <= items <= 25

Response Body

`application/json`

cURL

curl -X POST "https://example.com/discover/ask" \  -H "Content-Type: application/json" \  -d '{    "question": "string"  }'

{
  "success": true,
  "answer": "string",
  "citations": [
    {
      "n": -9007199254740991,
      "contentId": "21aa1683-ca25-4edf-bc18-01ad04a4821b",
      "title": "string",
      "platform": "string",
      "publishedAt": "string",
      "competitorId": "be7195ac-4482-4082-b43f-9e70c41e9fc4",
      "creatorName": "string"
    }
  ],
  "consultedCreators": [
    {
      "competitorId": "be7195ac-4482-4082-b43f-9e70c41e9fc4",
      "name": "string",
      "sourceCount": -9007199254740991
    }
  ],
  "totalCreators": -9007199254740991,
  "truncated": true,
  "chargedCredits": 0
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

{
  "error": "unauthorized"
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

{
  "success": false,
  "error": "API key lacks write permission"
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`