POpostproxy
Profiles

Backfill posts

Walks the profile's feed backwards from the newest post, importing in batches of 25, until it reaches from or the platform stops returning posts. Runs in the background - the response is the post sync record, which you poll for progress.

post/api/profiles/{id}/backfill_posts

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/profiles/{id}/backfill_posts
  • Auth
    HTTP bearer

Path parameters

idstring required

Profile id

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

Headers

Idempotency-Keystring

Optional idempotency key (up to 255 characters; a UUID is ideal). Retrying a successful write with the same key replays the original response (with an Idempotent-Replay: true header) instead of executing again. Stored responses are kept for 24 hours; only 2xx responses are stored.

Request body

fromstring required

ISO 8601 date/time, or a bare date meaning that date's start of day. The run stops at the first post published before this.

Response

Backfill accepted; returns the post sync record to poll for progress

idstring

Unique sync identifier.

profile_idstring

Profile this run belongs to.

kind'posts'

Always posts today.

trigger'connect' | 'scheduled' | 'backfill'
status'pending' | 'running' | 'completed' | 'failed'
started_atstring nullable

ISO 8601 timestamp when the run began.

completed_atstring nullable

ISO 8601 timestamp when it finished or failed.

posts_seeninteger

Posts the platform returned across the run.

posts_importedinteger

Posts that were new and got created. Lower than posts_seen whenever the run re-read posts you already have.

backfill_fromstring nullable

The date floor requested. null for connect and scheduled runs.

oldest_posted_atstring nullable

Publish date of the oldest post the run reached - how far back it has walked.

errorstring nullable

Platform error message when status is failed.

created_atstring

ISO 8601 timestamp.

Changes

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