Instagram APIthrough Siar.

At a glance

Account needed: An Instagram professional account (business or creator), connected through Facebook Login or Instagram Login.

Media rules

What Siar can do on Instagram

Siar can create comments and replies up to 2,200 characters, and import the comments people leave on your posts.

Publish a post

Put Instagram's payload under data.INSTAGRAM and list INSTAGRAM in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "Instagram post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "INSTAGRAM"
    ],
    "data": {
      "INSTAGRAM": {
        "type": "POST",
        "text": "Hello from Siar",
        "uploadIds": [
          "UPLOAD_ID"
        ]
      }
    }
  }'

Instagram fields

• type string default "POST"
  One of: POST REEL STORY
• text string nullable
• uploadIds string[] nullable
• altText string nullable
• thumbnailOffset number nullable default 0
• thumbnail string nullable
• shareToFeed boolean nullable default true
• collaborators string[] nullable
• autoFitImage boolean nullable default false
• autoCropImage boolean nullable default false
• tagged object[] nullable
  3 fields

  • username string required
  • x number ≥ 0≤ 1
  • y number ≥ 0≤ 1
• carouselItems object[] nullable
  3 fields

  • uploadId string required
  • altText string nullable
  • tagged object[] nullable
    3 fields

    • username string required
    • x number required ≥ 0≤ 1
    • y number required ≥ 0≤ 1
• locationId string nullable
• trialParams object nullable
  1 field

  • graduationStrategy string required
    One of: MANUAL SS_PERFORMANCE
• isPaidPartnership boolean nullable default false
• brandedContentSponsors string[] nullable max 2 itemseach: min length 1each: max length 30
• musicSoundInfo object nullable
  3 fields

  • musicSoundId string required min length 1
  • musicSoundVolume integer nullable ≥ 0≤ 100
  • videoOriginalSoundVolume integer nullable ≥ 0≤ 100
• isAiGenerated boolean nullable default false

Daily caps

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting an Instagram account

Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

• instagram_basic
• instagram_content_publish
• instagram_manage_comments
• instagram_manage_insights
• pages_show_list
• pages_read_engagement
• business_management
• instagram_manage_messages
• pages_messaging
• instagram_business_basic
• instagram_business_content_publish
• instagram_business_manage_comments
• instagram_business_manage_insights
• instagram_business_manage_messages

Instagram-specific operations

These exist for Instagram only and live under /misc/instagram.

When Instagram says no

Siar relays Instagram's error code and message verbatim on the post, next to a status you can act on. The Instagram error reference covers 10 common cases with what each one means and the fix. Open the Instagram error reference.