Import posts from a social account

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

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.

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

Path Parameters

idstring

Request 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

const body = JSON.stringify({})fetch("https://api.outstand.so/v1/social-accounts/string/imports", {  method: "POST",  headers: {    "Content-Type": "application/json"  },  body})
{
  "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"
  }
}
{
  "success": false,
  "error": "Session expired or invalid"
}
{
  "success": false,
  "error": "Social account not found"
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}