Core concepts

​

Brand

{
  "id": "1c9f6f0e-2b3a-4c5d-8e7f-0a1b2c3d4e5f",
  "name": "Acme Corp",
  "created_at": "2026-04-12T09:30:00Z"
}

• A new SocialAPI account starts with 1 brand named “Default”. Rename or delete it like any other brand.
• Your plan sets how many brands you can create. Pricing pages call a brand a profile. See Plans and usage, and read your current count with GET /v1/usage (Check your usage).
• A brand-restricted API key sees only its brands. Use brands to keep agency clients apart. See Brand restrictions.
• Creating a brand is not idempotent. Brand names are not unique, so a retried POST /v1/brands creates a duplicate. See Create requests are not idempotent.

​

Account

{
  "id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "platform": "instagram",
  "name": "Acme Corp",
  "username": "acmecorp",
  "brand_id": "1c9f6f0e-2b3a-4c5d-8e7f-0a1b2c3d4e5f",
  "status": "active",
  "permissions": null,
  "effective_permissions": ["posts.read", "posts.write", "comments.read", "comments.write", "messages.read", "messages.write", "analytics.read"]
}

​

Post

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "text": "Spring collection is live.",
  "status": "published",
  "targets": [
    {
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "platform": "instagram",
      "status": "published",
      "platform_post_id": "17895695668004550",
      "permalink": "https://www.instagram.com/p/ABC123/",
      "metrics": { "likes": 42, "comments": 5, "shares": 0, "saves": 0 }
    }
  ],
  "created_at": "2026-10-13T11:00:00Z"
}

• A request publishes only with publish_now or scheduled_at. With neither, POST /v1/posts saves a draft.
• A post is draft, scheduled, publishing, published, partial, failed, or cancelled. A target is pending, publishing, published, failed, or unpublished. See Post status.
• An HTTP success means SocialAPI accepted the post. Delivery to each platform finishes afterwards: read the post again or wait for a post.* webhook event. See Track post delivery.
• Metric names are the same on every platform. Where a platform reports a count, it uses the keys likes, comments, shares, and saves. A key the platform does not report is 0. A Google Business Profile target has no metrics object, or one whose four keys are all 0. LinkedIn and Pinterest targets return 501 resource.not_supported. Instagram, TikTok, YouTube, and Zalo add keys such as views: see Analytics.

​

Interaction

{
  "id": "sapi_cmt_GXRM4BNTW7KFYSD3HAEV6QJZ2CLP9U1I",
  "platform_id": "17858893269577012",
  "platform": "instagram",
  "text": "Love this product!",
  "author_id": "17841400008460056",
  "author_name": "Jane Smith",
  "author_username": "janesmith",
  "is_owner": false,
  "is_hidden": false,
  "parent_id": null,
  "created_at": "2026-10-13T14:30:00Z",
  "capabilities": {
    "can_reply": true,
    "can_delete": true,
    "can_hide": true,
    "can_like": false,
    "can_private_reply": true
  }
}

​

Capability

​

Related

• Quickstart to use all five objects in one walkthrough
• Connect accounts to create accounts and read their status
• Unified inbox to read and answer interactions
• Publishing to send posts to accounts
• IDs for the ID format of every object
• Supported platforms for what each platform allows