API Reference

Threads API

Threads' API requires Instagram Business account linking, Facebook app review, and media container polling. Zernio skips all of that with one endpoint for text, images, and video posts.

Get API Key Full Documentation

Quick Start

1.
Get API Key
Sign up for free and get your API key in seconds.
2.
Connect Account
Use our OAuth flow to connect Threads accounts.
3.
Start Posting
Make API calls to post content to Threads.

Post to Threads

JavaScript

const response = await fetch('https://zernio.com/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Just shipped something cool! What do you think? 🚀',
    mediaItems: [{ type: 'image', url: 'https://example.com/screenshot.png' }],
    platforms: [{
      platform: 'threads',
      accountId: 'acc_abc123'
    }],
    publishNow: true
  })
});

const post = await response.json();
console.log(post.post._id); // '65f1c0a9e2b5af0012ab34cd'

Threads Endpoints

POST/v1/posts

Create or schedule a Threads post (text, image, or video)

GET/v1/posts/{id}

Get status and details of a Threads post

DELETE/v1/posts/{id}

Cancel a scheduled Threads post

GET/v1/profiles

List all connected Threads accounts

View full API reference →

Media Requirements

Type	Format	Max Size	Notes
Image	JPEG, PNG	8 MB	Up to 10 images per post
Video	MP4, MOV	1 GB	Up to 5 min duration
Text	UTF-8	500 chars	Links auto-embedded

Zernio automatically transcodes and optimizes media for Threads's requirements.

API Limits

Threads API has rate limits tied to Instagram's Graph API. Zernio manages these limits automatically, ensuring reliable posting.

Zernio handles all rate limiting automatically. We queue and retry requests as needed.

Features

✓Post text, images, and videos
✓Schedule posts for optimal times
✓Multi-image posts supported
✓Reply thread creation
✓Multi-account management
✓Webhook notifications for post status
✓Instagram account linking

Response Example

Response

JSON

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "content": "Just shipped something cool! What do you think? 🚀",
    "platforms": [{
      "platform": "threads",
      "accountId": { "_id": "acc_abc123", "username": "@yourhandle" },
      "status": "published",
      "platformPostId": "3456789012345678901",
      "platformPostUrl": "https://threads.net/@yourhandle/post/ABC123"
    }],
    "publishedAt": "2025-01-10T10:30:00Z"
  },
  "message": "Post published successfully"
}

Start building with Threads API

Free tier available · No credit card required · 99.97% uptime

Get Free API Key Read Documentation →