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

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.

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"
}