TOtoksta
Evidence

Get posts behind search results

Return the LinkedIn posts behind search results (keyword evidence) for a creator selection.

Keywords: provide keywords (array of strings) OR a result_set_id/result_set_ids (keywords are then inferred from the saved search). Sending creator_ids alone, with no keywords and no result set, returns 400.

post/v1/search-results/posts

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

keywordsstring[]

Keywords to match posts against. Required unless a result_set_id/result_set_ids is provided.

posts_limit_per_creatorinteger

Evidence posts per creator (1-10). Defaults to 3.

detail_level'summary' | 'full'

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

Example request

{
  "creator_ids": [
    "f0e1d2c3-b4a5-4678-9abc-def012345678"
  ],
  "keywords": [
    "developer tools",
    "API"
  ],
  "posts_limit_per_creator": 3
}

Response

Keyword evidence posts per creator.

successtrue required
dataobject required

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

Example response

{
  "success": true,
  "data": {
    "keywords_used": [
      "developer tools",
      "API"
    ],
    "selection": {
      "source": "creator_ids",
      "selected_count": 1
    },
    "results": [
      {
        "creator": {
          "id": "f0e1d2c3-b4a5-4678-9abc-def012345678",
          "name": "Jane Marketer",
          "handle": "jane-marketer",
          "platform": "linkedin",
          "profile_url": "https://www.linkedin.com/in/jane-marketer/"
        },
        "cached_post_count": 42,
        "matched_posts_count": 2,
        "matched_keywords": [
          "developer tools"
        ],
        "evidence_posts": [
          {
            "post_url": "https://www.linkedin.com/posts/jane-marketer_...",
            "posted_at": "2026-05-18T08:00:00Z",
            "keyword_matches": [
              "developer tools"
            ],
            "relevance_score": 22,
            "snippet": "Why developer tools win on DevEx...",
            "reactions": 410,
            "comments": 34,
            "shares": 9
          }
        ]
      }
    ],
    "unsupported_creators": [],
    "detail_level": "summary",
    "posts_limit_per_creator": 3
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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