Threads API

The Threads API for text, photos & video

Publish text posts and media carousels to Threads from your own code, with alt text on every image. Meta's container flow is handled for you.

What you can publish

Every Threads format, one endpoint

The same request that posts everywhere else, with the fields Threads needs and nothing it doesn't.

Text posts

Up to 500 characters, no media required.

text

Carousels

Up to 10 images and videos on one post, mixed freely.

uploadIds

Alt text

Describe each image or video for screen readers through mediaItems.

mediaItems

Analytics

Profile and post metrics, with reposts and quotes counted together as shares.

Beyond publishing

More than a way to post to Threads

Everything around the post — when it goes out, how it performs, where else it lands — through the same API.

Scheduling

Schedule Threads posts to the minute

Give a post a time and Bulkit publishes it then. Queue a week — or a quarter — of Threads content in one go, and let retries and rate limits take care of themselves.

  • Any time zone
  • Retries built in
  • Rate limits handled
Analytics

Threads analytics, in one schema

Profile and post metrics for posts after April 2024. Shares combine reposts and quotes. Same response shape as every other network, so there's nothing to reconcile.

  • Post metrics
  • Profile metrics
  • Shares
Cross-posting

Threads and 11 more networks in one call

Add targets to the same request and one payload fans out everywhere, with each network getting the fields it needs. Upload media once and reuse it on every channel.

  • One API key
  • One schema
  • No per-network fees
AI agents

Let your AI agent post to Threads

Bulkit's MCP server gives Claude, Cursor or any MCP-compatible agent real tools to publish and schedule to Threads — the same actions your code calls.

  • Claude & Cursor
  • Scoped API keys
  • Every call logged
Threads at a glance

The Threads API's sharp edges, filed down

Threads limits and capabilities
SpecThreads
FormatsText, image, video, mixed carousel
Post textUp to 500 characters
Media0–10 images or videos
ImagesUp to 8 MB, 320–1440px wide
Aspect ratio0.01:1 to 1.91:1
AnalyticsProfile and post metrics, for posts after April 2024

Built on Instagram's rails

Threads runs on Instagram's infrastructure. Bulkit handles that plumbing so a Threads post is just another target.

Media limits, known

Images must be 320–1440px wide and under 8 MB; video tops out at 100 Mbps. The numbers are here before your upload fails.

Accessible by default

Every item in mediaItems takes altText, so carousels posted by code stay readable with a screen reader.

Analytics, with the caveats

Metrics exist only for posts after April 2024, and shares combine reposts and quotes. Both are documented, not discovered.

Threads is one of 12 channels

Add a target and the same post goes out everywhere else too — one key, one schema, no per-network fees.

FAQ

Threads API: common questions

  • Does Threads have a posting API?

    Yes. Meta offers one, and Bulkit wraps it: send a post with text and up to 10 images or videos and it publishes to Threads.

  • Can I schedule Threads posts?

    Yes. Give the post a postDate and Bulkit publishes it at that time.

  • What media can I attach?

    Up to 10 images and videos, mixed. Images can be up to 8 MB and 320–1440px wide, with aspect ratios from 0.01:1 to 1.91:1.

  • What Threads analytics are available?

    Rolling profile metrics and lifetime post metrics. Threads only reports on posts published after April 2024, and counts reposts and quotes together as shares.

  • How much does it cost?

    $4.99/month with 500 actions included, then $0.01 per action. Threads is included with every other network.

Your first Threads post is one request away

$4.99/mo with 500 actions included, then $0.01 each. Threads and every other network on the same key.