API Reference

Threads API

Post text, images, and videos to Threads with a single API call.

Get API Key Full Documentation

Quick Start

Get started in 3 steps

Get API Key

Connect Account

Use our OAuth flow to connect Threads accounts.

Start Posting

Make API calls to post content to Threads.

Post to Threads

JavaScript

const response = await fetch('https://getlate.dev/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'

Endpoints

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 Specs

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

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

Rate Limits

API Limits

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

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

Capabilities

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

Response Example

Response

200 OK

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

Skip the Threads API complexity. Late handles OAuth with Instagram and rate limits so you can ship faster.

Get Free API Key Read Documentation →

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