Profiles

Follower history

Daily follower movement for a date range, one record per day, from a daily rollup refreshed once a day per network. Follower data is collected for facebook, instagram, youtube, and tiktok profiles. Days with no follower data are omitted rather than returned as all-null records.

Billing: Read request · Rate limit: 120/min

get/v1/social/profiles/{id}/follower_history

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/social/profiles/{id}/follower_history
  • Auth: HTTP bearer

Path parameters

idstring required

Profile id

Query parameters

tostring date

ISO 8601 date. Defaults to yesterday.

fromstring date

ISO 8601 date. Defaults to 29 days before to. The range is capped at 366 days.

placement_idstring

Required for placement networks (facebook, linkedin, telegram, google_business) - the placement ID from List placements. Of these, only Facebook reports follower data.

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.