TOtoksta
Analysis

Get audience match results

Fetch audience-match analysis results. Same dual selection model as content match: job_id/job_ids (accepting audience-fit:<uuid> or bare UUID) OR creator_ids/result sets + optional campaign_id. detail_level: "full" adds the results array.

post/v1/audience-match/results

Request

Request body

job_idstring

A single audience-match job ID (audience-fit:<uuid> or bare UUID).

job_idsstring[]
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]).

campaign_idstring

Optional campaign UUID to scope creator-based lookups.

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

{
  "job_id": "audience-fit:a5f1eeb5-ee98-41bc-8b2c-3d4e5f6a7b8c",
  "detail_level": "summary"
}

Response

Audience-match results summary. Call /v1/audience-match/details for full breakdowns.

successtrue required
dataobject required

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

Example response

{
  "success": true,
  "data": {
    "selection": {
      "source": "job_id",
      "selected_count": 1
    },
    "requested_count": 1,
    "found_count": 1,
    "not_found_ids": [],
    "expired_ids": [],
    "results_summary": [
      {
        "job_id": "audience-fit:a5f1eeb5-ee98-41bc-8b2c-3d4e5f6a7b8c",
        "analysis_id": "a5f1eeb5-ee98-41bc-8b2c-3d4e5f6a7b8c",
        "creator_id": "f0e1d2c3-b4a5-4678-9abc-def012345678",
        "creator_name": "Jane Marketer",
        "platform": "linkedin",
        "status": "succeeded",
        "match_score": 71,
        "matching_engagers_count": 134,
        "total_engagers_analyzed": 300,
        "unique_companies": 88,
        "audience_summary": "Audience skews senior B2B marketing and growth leaders.",
        "recommended_next_endpoint": "/v1/audience-match/details",
        "completed_at": "2026-05-28T09:12:00Z",
        "updated_at": "2026-05-28T09:12:00Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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