TOtoksta
Analysis

Get audience match details

Fetch detailed audience-match breakdowns (top engagers, companies, job titles, geography). Same selection model as /v1/audience-match/results. engagers_limit controls how many engagers are returned.

post/v1/audience-match/details

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.

engagers_limitinteger

Top engagers to return (1-30). Defaults to 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

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

Response

Detailed audience-match 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": [],
    "detail_level": "full",
    "engagers_limit": 10,
    "results": [
      {
        "job_id": "audience-fit:a5f1eeb5-ee98-41bc-8b2c-3d4e5f6a7b8c",
        "creator_id": "f0e1d2c3-b4a5-4678-9abc-def012345678",
        "status": "succeeded",
        "match_score": 71,
        "total_engagers_analyzed": 300,
        "matching_engagers_count": 134,
        "unique_companies": 88,
        "audience_summary": "Audience skews senior B2B marketing and growth leaders.",
        "top_matching_engagers": [
          {
            "name": "Sam B.",
            "job_title": "VP Marketing",
            "company": "Acme",
            "headline": "VP Marketing at Acme",
            "linkedin_url": "https://www.linkedin.com/in/sam-b/",
            "engagement_count": 4
          }
        ],
        "top_companies": [
          {
            "name": "Acme",
            "count": 12,
            "percentage": 8.9
          }
        ],
        "job_title_breakdown": [
          {
            "title": "VP Marketing",
            "count": 18
          }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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