Search accounts, creators & videos

curl --request GET \
  --url https://api.creatoraudit.com/v2/search \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.creatoraudit.com/v2/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

Search accounts, creators & videos

Return up to limit matches per entity type, wrapped in the standard v2 envelope.

Powers the dashboard command palette (Cmd+K). Response shape:

{
  "data": {
    "accounts": [{ id, platform, username, display_name }, ...],
    "creators": [{ id, name }, ...],
    "videos":   [{ id, platform, caption, account_id, account_username }, ...]
  },
  "meta": {
    "query": "<q as sent>",
    "limit_per_section": <requested>,
    "effective_caps": { accounts, creators, videos }
  }
}

meta.effective_caps surfaces the per-section cap the service actually applied — it is min(limit, _MAX_*) and previously the service silently clamped lower than the router’s le=25 allowed, so a client sending limit=25 could not tell why it only got 10 results. Deep-audit findings search-no-response-envelope and search-service-hidden-cap.

Empty / whitespace q returns empty sections.

GET

Search accounts, creators & videos

curl --request GET \
  --url https://api.creatoraudit.com/v2/search \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.creatoraudit.com/v2/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "BAD_REQUEST",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

string

default:""

Case-insensitive substring matched against account usernames, creator names, and video captions in the caller's organization.

Maximum string length: 128

limit

integer

default:10

Max matches per entity type (1–25).

Required range: 1 <= x <= 25

Response

Successful Response

Conventions

Accounts

Videos

Creators

Analytics

Overview

Search

System

Search accounts, creators & videos

Authorizations

Query Parameters

Response