Posts

Post stats

Retrieves stats snapshots for one or more posts. Returns all matching snapshots (not just the latest) so you can see trends over time, with optional filtering by profiles/networks and timespan.

Billing: Read request · Rate limit: 120/min

get/v1/social/posts/stats

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/social/posts/stats
  • Auth: HTTP bearer

Query parameters

tostring date-time

ISO 8601 timestamp — only include snapshots recorded at or before this time

fromstring date-time

ISO 8601 timestamp — only include snapshots recorded at or after this time

post_idsstring required

Comma-separated list of post ids (max 50)

profilesstring

Comma-separated list of profile ids or platform names (e.g. instagram,twitter or abc123,def456 or mixed). Platform names are matched against known platforms; anything else is treated as a profile id.

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.