Ingest content

Push self-scraped items into Discover. Free, idempotent upsert on (platform, externalId).

POST/v1/discover/content/ingest

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.

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

Existing creator id. Provide this OR creator (exactly one is required).

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

creator?

Find-or-create by platform handle when no creatorId is given (exactly one of the two is required).

items*array<>

Items1 <= items <= 500

Response Body

`application/json`

cURL

curl -X POST "https://example.com/discover/content/ingest" \  -H "Content-Type: application/json" \  -d '{    "platform": "youtube",    "items": [      {        "externalId": "string",        "publishedAt": "string"      }    ]  }'

{
  "success": true,
  "creatorId": "688ebf54-d343-4104-8711-82c2feac534a",
  "creatorCreated": true,
  "ingested": -9007199254740991,
  "skipped": -9007199254740991
}

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

{
  "error": "unauthorized"
}

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

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

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`