TOtoksta
Jobs

Get one job result

Fetch the full result of one creator-discovery job. job_id must be a plain UUID (not prefixed). Use limit (alias results_limit, max 200) to cap the number of candidate rows returned.

post/v1/jobs/results

Request

Request body

job_idstring required

Discovery job UUID (plain, unprefixed). REQUIRED.

limitinteger

Max candidate rows (1-200). Defaults to 50. Alias: results_limit.

Example request

{
  "job_id": "56232ac2-8068-4dcb-9d1a-1f2e3a4b5c6d",
  "limit": 50
}

Response

Single discovery job result with candidate rows.

successtrue required
dataobject required

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

Example response

{
  "success": true,
  "data": {
    "job": {
      "job_id": "56232ac2-8068-4dcb-9d1a-1f2e3a4b5c6d",
      "job_type": "creator_discovery",
      "status": "succeeded",
      "source_status": "completed",
      "is_terminal": true,
      "progress": {
        "total_items": 120,
        "completed_items": 120,
        "approved_items": 38,
        "failed_items": 82
      },
      "platform": "linkedin",
      "campaign_id": null,
      "created_list_id": null,
      "result_expires_at": "2026-06-27T09:06:00Z",
      "result_retention_days": 30,
      "results_truncated": false,
      "result_count": 1,
      "results": [
        {
          "creator_id": "f0e1d2c3-b4a5-4678-9abc-def012345678",
          "creator_name": "Jane Marketer",
          "status": "approved",
          "search_rank": 1,
          "relevance_score": 0.92,
          "relevance_reasoning": "Strong topical match.",
          "processed_at": "2026-05-28T09:05:00Z"
        }
      ]
    }
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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