TOtoksta
Enrichment

Get enrichment results

Fetch enrichment results for a creator selection.

Selection (provide one): creator_ids (array of UUIDs), result_set_id, or result_set_ids. Because enrichment can complete synchronously (no job IDs), creator_ids is the reliable way to retrieve results. Set detail_level: "full" to include the results array with extended fields. Use wait_seconds to poll inline.

post/v1/enrichments/results

Request

Request body

creator_idsstring[]

Creator UUIDs to operate on. Takes precedence over result_set_id / result_set_ids when provided.

result_set_idstring

A single result_set_id returned by a prior discovery search. Resolved to its ranked creators.

result_set_idsstring[]

Multiple result set IDs to merge (dedupe) into one creator selection.

top_ninteger

When selecting from result set(s), take only the top N ranked creators.

ranksinteger[]

When a single result_set_id is provided, select specific 1-based ranks (e.g. [1,3,5]).

detail_level'summary' | 'full'

Response verbosity. summary (default) returns trimmed fields; full returns the complete records.

wait_secondsinteger

Optional inline poll. Holds the request up to this many seconds (max 30) waiting for jobs to reach a terminal state before returning. Defaults to 0 (return immediately).

Example request

{
  "creator_ids": [
    "f0e1d2c3-b4a5-4678-9abc-def012345678"
  ],
  "detail_level": "summary",
  "wait_seconds": 10
}

Response

Enrichment results. results (full records) is present only when detail_level=full. meta includes detail_level and wait_seconds.

successtrue required
dataobject required

Operation payload. See the example for the exact field structure.

Example response

{
  "success": true,
  "data": {
    "creators_requested": 1,
    "completed": 1,
    "pending": 0,
    "selection": {
      "source": "creator_ids",
      "selected_count": 1
    },
    "results_summary": [
      {
        "creator_id": "f0e1d2c3-b4a5-4678-9abc-def012345678",
        "name": "Jane Marketer",
        "profile_url": "https://www.linkedin.com/in/jane-marketer/",
        "followers_count": 48200,
        "median_posts_per_month": 12,
        "engagement_rate": 2.31,
        "enriched_at": "2026-05-28T09:06:00Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.