Read stored profile-post history

Social listening

post /v1/listening/profile-history

Returns a cursor-paginated page of stored Basic posts for social listening. Profile history is never embedded in profile Basic or Enriched responses.

Authentication

• ApiKey bearer token

  Send the current Benchmark API key only in the Authorization header.

Request body

• target EntityTarget required

  A Benchmark entity UUID, platform-native ID, handle, or public URL. Platform can be omitted when the URL identifies it. Link targets require a public HTTPS URL or an existing Benchmark link UUID; HTTP, credentials, local/internal hosts, and non-443 ports are rejected.

• cursor string optional

  The opaque cursor returned as nextCursor by the previous stored page. Pass it back unchanged.

Responses

• 200

  A stored page of Basic posts.

• 400

  The request failed validation.

• 401

  The bearer credential is missing or invalid.

• 402

  The organization needs plan or purchased-credit entitlement, has reached its separate monthly spend cap, or cannot cover the operation within the entitled grace floor.

• 403

  The key cannot perform this operation.

• 404

  The canonical entity is not stored. The error includes the exact refresh request that can create it.

• 429

  The Cloudflare rate limiter rejected the request.

• 500

  The request failed without exposing internal diagnostics.

• 503

  A required service is unavailable.

Request

cURL

curl --request POST \
  --url "${BENCHMARK_API_BASE_URL}/v1/listening/profile-history" \
  --header "Authorization: Bearer ${BENCHMARK_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"target":{"platform":"youtube","reference":"@mkbhd"}}'

Response

200

{
  "data": [
    {
      "entityType": "post",
      "entityId": "30000000-0000-4000-8000-000000000003",
      "platform": "youtube",
      "platformId": "dQw4w9WgXcQ",
      "canonicalUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "creatorEntityId": "50000000-0000-4000-8000-000000000005",
      "creatorPlatformId": "UCBJycsmduvYEL83R_U4JriQ",
      "collaborators": [],
      "title": "Example video",
      "caption": "An example public post.",
      "publishedAt": "2026-08-20T15:00:00.000Z",
      "contentType": "video",
      "metrics": {
        "bookmarkCount": null,
        "commentCount": 120,
        "impressionCount": null,
        "likeCount": 8400,
        "quoteCount": null,
        "repostCount": null,
        "saveCount": null,
        "shareCount": 310,
        "videoPlayCount": null,
        "viewCount": 124000
      },
      "observedAt": "2026-08-24T12:00:00.000Z",
      "isEnriched": false
    }
  ],
  "meta": {
    "profileEntityId": "50000000-0000-4000-8000-000000000005",
    "nextCursor": "30000000-0000-4000-8000-000000000003"
  }
}