Import posts from a social account

Enqueues an import job to fetch and store existing posts from the connected social account platform.

Enqueues an import job to fetch and store existing posts from the connected social account platform. The job runs asynchronously - poll the returned import ID or listen for an import.completed / import.failed webhook event.

Supported networks: Bluesky, LinkedIn, Facebook, Instagram, Threads, TikTok, YouTube, Pinterest, Google Business

Facebook: Imports automatically include published Page posts and Reels, using one shared date range and limit. Reels are discovered through Meta's Page video_reels endpoint. Instagram-crossposted Reels are included when Meta exposes them through that endpoint; the "Published by Instagram" label alone does not guarantee API availability. Stories are not imported.

Note: LinkedIn post imports are only supported for business (organization) accounts - personal LinkedIn accounts cannot import posts.

Unsupported: X (Twitter) - API tier restrictions prevent user timeline access.

Billing: Each successfully imported post counts as one social_posts usage unit, billed the same day the import runs.

Permissions: Requires posts:create. Access is limited by the API key creator's current organization membership and stored key ceiling. See Organization permissions.

POST
/v1/social-accounts/{id}/imports

Path Parameters

id*string

Request Body

application/json
  1. body
since?string

Import posts published after this ISO 8601 timestamp

Formatdate-time
until?string

Import posts published before this ISO 8601 timestamp

Formatdate-time
limit?integer

Maximum number of posts to import

Range0 < value <= 1000

Response Body

Import job created and queued

application/json
  1. response
success*boolean
data*

Import job status

Example Request
curl -X POST 'https://api.outstand.so/v1/social-accounts/string/imports' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "success": true,  "data": {    "id": "string",    "orgId": "string",    "socialAccountId": "string",    "status": "queued",    "since": "string",    "until": "string",    "limit": 0,    "imported": 0,    "skipped": 0,    "failed": 0,    "error": "string",    "createdAt": "string",    "updatedAt": "string",    "completedAt": "string"  }}