--- title: "Threads API" description: "Use Ayrshare's Threads API to publish text posts, carousels, and threads, schedule them, and get analytics for your users, without waiting on Meta's app review." canonical: https://www.ayrshare.com/threads-api/ lastModified: 2026-11-05 pageType: landing --- # Threads API > Use Ayrshare's Threads API to publish text posts, carousels, and threads, schedule them, and get analytics for your users, without waiting on Meta's app review. ## Threads API for Posting, Scheduling, and Analytics Ayrshare's Threads API lets developers publish text posts, images, videos, carousels, and multi-post threads to Threads profiles via a single REST endpoint. It supports scheduled posts, link previews, geo restrictions, comments, history, and analytics across 14+ social networks through one integration. Your users link their own Threads profiles through an OAuth flow inside your product, on Ayrshare's approved Meta app. You don't need your own App Review, Threads permissions, or token refresh logic. [Read the Threads Docs](/docs/apis/post/social-networks/threads) [Get Your API Key](/pricing/) - **>99.99%** — API uptime - **30M+** — API calls per day - **14+** — Social media networks - **AI-Native** — Native MCP server for any AI agent ## What Do You Need to Use the Threads API? You need one API key and a user who links their Threads profile. Ayrshare holds the approved Meta app, so there is no App Review per permission, no Business Verification, and no tester-only phase before your first post. After that, Ayrshare keeps the integration running: long-lived token refresh, Meta's API versions, media re-hosting when Meta can't fetch a file, and new Threads features as Meta ships them. - **Access**: Your users link their Threads profiles on Ayrshare's approved Meta app. You skip App Review for threads_basic, threads_content_publish, and the reply and insights permissions. - **Ongoing maintenance**: Meta changes the Threads API as it grows. Ayrshare refreshes tokens before they expire, tracks new versions, and adds features like geo restrictions and carousels as they ship, so you don't have to. - **Account types**: Any Threads profile, public or private, linked by the person who owns it. - **Threads and carousels**: Send text over 500 characters with thread set to true and Ayrshare splits it into a numbered series at your blank lines, with one media item per post. Send up to 20 image and video URLs for a carousel. ## Post and Schedule to Threads in Your Language Each sample publishes a photo post now, then schedules a video for later. Same endpoint, same JSON, in Node.js, Python, PHP, Java, Go, Ruby, C#, or plain cURL. Add a Profile-Key header to post for one of your users. [Full Post API Reference](/docs/apis/post/overview) - **cURL** - **Node.js** - **Python** - **PHP** - **Java** - **Go** - **Ruby** - **C#** ## Threads API Limits: Post Types, Media, and Characters Meta's rules for Threads in one place. The full list lives in the [Threads media guidelines](/docs/media-guidelines/threads) and the [Threads publishing options](/docs/apis/post/social-networks/threads). - **5 post types (Post types)**: Text, links with an automatic preview, a single image or video, carousels, and multi-post threads. Media can go out with no text at all. Posts go to a Threads profile linked by the person who owns it. - **8 MB per image (Images)**: JPEG or PNG, with an aspect ratio of at most 10:1 and a width of 320 to 1440 px. Meta scales anything outside that range. WebP, HEIC, HEIF, and AVIF are converted to JPEG. - **5 min max length (Video)**: MP4 or MOV, H.264 or HEVC with AAC audio, up to 1 GB. 23 to 60 FPS, up to 1920 px wide, 25 Mbps max bitrate. 9:16 is recommended. - **500 characters per post (Characters)**: Up to 500 characters per post and one hashtag. Each @mention notifies the user. - **20 items per carousel (Carousels)**: Up to 20 images and videos in mediaUrls, mixed in any order. Video URLs need a known extension, or set isVideo. - **1/n numbering (Threads of posts)**: Set thread to true and Ayrshare splits text over 500 characters into a connected series at sentence boundaries, or at the blank lines you place. Add 1/n numbering and one media item per post. - **ISO country codes (Geo restrictions)**: Limit a post or a whole thread to listed countries with allowCountries, on accounts where Meta has turned this on. - **250 API posts per day (Scheduling and limits)**: Pass a scheduleDate to publish later, for any date. Meta allows 250 API-published posts per profile in any 24 hours. Ayrshare allows 300 API calls per 5 minutes per profile. ## What Else Can You Do With the Threads API? - **Split long text into a thread**: Send the full text with thread set to true. Ayrshare splits it at blank lines, numbers each post, and attaches one media item per post in order. Use null to skip media on a post, or an object with several URLs for a carousel inside one post. - **Publish a mixed-media carousel**: Add up to 20 URLs to mediaUrls, with images and videos mixed. Threads fetches each file from your URL, so the host has to let Meta's crawler through. - **Limit a post to listed countries**: Pass ISO 3166-1 alpha-2 country codes in allowCountries, on a single post or a thread. Check isEligibleForGeoRestrictions on the /user endpoint first: if Meta hasn't turned geo restrictions on for the account, the request returns code 101 and nothing publishes. - **Post a link with a preview card**: Leave mediaUrls out and Threads renders a preview card for the first link. Add an image or video and the media shows instead of the preview. ## Why Use Ayrshare Instead of the Threads API Directly? Ayrshare runs the Meta app, so your product sends one request and gets back the Threads post ID and URL. Meta fetches media from your server when you publish, so a robots.txt rule or a bot filter on your host can fail the post. Ayrshare retries media Meta can't fetch and re-hosts it on Ayrshare's CDN when needed. It also runs the linking flow, builds carousels from a list of URLs, and cuts long text into a thread of posts under 500 characters. When Meta changes the Threads API, the fix ships on our side, not in your sprint. For a step-by-step walkthrough, read [How to Post to Threads with an API](/blog/threads-api-integration-authorization-posting-analytics-with-ayrshare/). [See the Threads Publishing Options](/docs/apis/post/social-networks/threads) - **One simple endpoint**: Just send a single POST request with your text, media URLs, and the user's Profile-Key. Add thread, allowCountries, or a carousel in the same request. We keep the integration lean so your team can launch faster. - **We deal with Meta**: Profile linking, token refresh, media fetching and re-hosting, carousel containers, and thread splitting. None of it reaches your code. - **Analytics on every post**: Get the Threads post ID and URL right away. The same ID returns views, likes, replies, reposts, quotes, and shares per post, plus profile followers and views, in the same JSON format as every other network. ## Beyond Posting: The Rest of the Threads Lifecycle The same Threads connection that publishes also reads comments, pulls history for posts made in the app, and returns analytics. Every option above is in the [Threads API docs](/docs/apis/post/social-networks/threads). See every network you can reach with the same integration on the [supported networks page](/supported-networks/). - **Analytics**: Per post: views, likes, replies, reposts, shares, and quotes. Per profile: followers, views, likes, replies, reposts, quotes, and verification status, in the same JSON shape as every other network. - [Analytics API](/social-media-analytics-api/) - **Comments**: Read the replies on a Threads post, including nested replies and quote posts, and delete comments by Ayrshare ID or Threads comment ID. - [Engagement API](/social-media-engagement-api/) - **History**: Pull a profile's past posts with analytics, including posts published in the Threads app, and look up any one post by its Threads ID. - [History API](/history-api/) - **Pre-publish checks**: Check a post's weighted character count against the 500 limit before sending it, with emoji and accented characters counted the way Threads counts them. - [Post length endpoint](/docs/apis/validate/check-post-length) - **Scheduling**: Schedule a post, carousel, or whole thread for any date. Ayrshare builds the media containers and publishes each post of the thread in order at that time. - [Post API reference](/docs/apis/post/overview) ## FAQs About the Threads API ### Can I post to Threads through an API? Yes, you can post to Threads through an API. Ayrshare's Threads API lets developers publish text posts, images, videos, carousels, and multi-post threads to Threads profiles via a single REST endpoint. It supports scheduled posts, link previews, geo restrictions, comments, history, and analytics across 14+ social networks through one integration. Start with the [Threads publishing options](/docs/apis/post/social-networks/threads). ### Is the Threads API free? The Threads API is free to call, since Meta publishes no fee or paid tier for it. Going direct costs you setup and upkeep instead: App Review for each permission, 60-day token refreshes, and Meta's limit of 250 API-published posts per profile a day. Ayrshare's plans include Threads posting on Ayrshare's approved Meta app, so you can start posting without waiting on review. [Compare Ayrshare plans](/pricing/). ### How do I get access to the Threads API? To get access to the Threads API, create a Meta app with the Threads use case, request threads_basic and threads_content_publish, and pass App Review for each permission before publishing the app. Until then, only invited testers can use it. With Ayrshare, your users link their Threads profiles through Ayrshare's approved app, and the [Post API reference](/docs/apis/post/overview) shows the one request you need. ### How do I publish to Threads with an API step by step? To publish to Threads with an API through Ayrshare, get an API key, have your user link their Threads profile, then send the post text and any media URLs to the /post endpoint with platforms set to threads. Add thread to split long text into a series. The tutorial [How to Post to Threads with an API](/blog/threads-api-integration-authorization-posting-analytics-with-ayrshare/) walks through each step. ### What analytics are available through the Threads API? The analytics available through the Threads API cover each post and the whole profile. Meta's insights return likes, replies, reposts, quotes, views, and shares per post, and followers, views, link clicks, and follower demographics per profile, with demographics needing 100 followers. Insights need the threads_manage_insights permission. Ayrshare returns post and profile metrics in one JSON shape through the [Analytics API](/social-media-analytics-api/). ### What are the Threads API rate limits? The Threads API rate limits cap each profile at 250 API-published posts, 1,000 replies, and 100 deletions in any 24 hours, and a carousel counts as one post. General calls scale with the profile's impressions. Ayrshare adds its own limit of 300 API calls per 5 minutes per profile, across every network on its [social media publishing API](/social-media-publishing-api/), so plan bulk scheduling around both. ## Your Users Are on Threads. Your Product Can Be Too. Get an API key, publish your first Threads post, and turn on the other networks with the same call when you need them. [Get Your API Key](/pricing/) [Read the Threads Docs](/docs/apis/post/social-networks/threads)