Skip to content
Benchmark

Refresh profile-post history

Social listening
post /v1/listening/profile-history/refresh

Starts a bounded Basic profile-history collection. The first successful poll returns up to ten current stored posts and a stored-data pagination cursor.

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.

  • maxPostAgeDays integer optional

    Collect only posts published within this many days.

  • maxPosts integer optional

    The maximum number of unique Basic posts to collect.

Responses

  • 202

    The collection was accepted.

  • 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.

  • 429

    The Cloudflare rate limiter rejected the request.

  • 500

    The request failed without exposing internal diagnostics.

  • 503

    A required service is unavailable.