ThreadsExplainer

Threads API: Meta's limits and public profiles as JSON

Meta's Threads API reads your own account. Ours returns any public profile, post or search as JSON for 1 credit a call, with one API key.

3 min read

Short answer

  • Meta's official Threads API publishes and reads for the account that authorized your app. Its keyword search covers only your own posts until Meta approves the permission.
  • On standard access, Meta's profile lookup works only for some official Meta accounts, such as @threads. Each user gets 1,000 lookups per rolling 24 hours.
  • ToolzerHub returns public Threads profiles, posts and search results as JSON with one API key. Each call costs 1 credit, and 100 credits a month are free.
On this page

You want Threads data from accounts you do not run: a competitor's follower count, a creator's latest posts, what people write about a keyword. Meta publishes an official Threads API. Most of it works only on the account that logged in to your app.

What the official API gives you

Meta's Threads API is built for publishing on a person's behalf. With that person's access token you can post, reply, moderate replies, read mentions and read insights, and reading is tied to the same account: the profile and posts endpoints return only the app-scoped user's data.

Meta also has a Profile Discovery API for other accounts. GET /profile_lookup returns a public profile's name, bio, follower count, verified flag and 7-day likes, reposts and views counts, and GET /profile_posts returns that profile's posts. Both need the threads_profile_discovery permission. Keyword search (GET /keyword_search) can cover public posts too, filters by date, media type and author, and returns up to 100 results per call.

Where it stops

Profile Discovery is gated. On standard access, lookup works for "only some of the official Meta accounts", such as @meta, @threads, @instagram and @facebook. Anyone else needs Advanced Access, which Meta grants per permission through App Review and Business Verification. The endpoint also returns only public profiles with at least 100 followers and allows 1,000 requests per user in a rolling 24 hours.

Keyword search has the same shape. Until threads_keyword_search is approved, it searches only your own posts. After approval, public posts are searchable, up to 2,200 queries per user per rolling 24 hours. The keyword search guide has a script that exports results with like counts, and how to scrape Threads with Python reads public profiles and posts without any API.

Use Meta's API to publish, moderate replies or read insights for accounts you run, or when your app has advanced access and you want its 7-day counts and date filters.

Get any public profile in one request

We make ToolzerHub. Our Threads API returns public Threads profiles, posts and search results as JSON. You need one API key, with no Meta developer app, no OAuth flow and no Threads login.

bash
curl "https://api.toolzerhub.com/v1/threads/profile?username=threads" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"

The call returns one profile, trimmed here to five fields:

json
{
  "data": {
    "username": "threads",
    "full_name": "Threads",
    "id": "63082166531",
    "follower_count": 6962731,
    "is_verified": true
  }
}

We used @threads because Meta lists it among the accounts its standard access can look up, so you can compare both responses. The same call takes any public username, @handle or profile URL.

  • profile returns a public profile. Its id is the Threads user ID, not the account's Instagram ID; finding a Threads user ID covers lookups in bulk.
  • profile/posts takes that ID as user_id, and you send each response's page_info.end_cursor as end_cursor for the next page.
  • post returns one post by URL, and include_replies=true adds its public replies.
  • search returns posts or, with serp_type=tags, tag results for q: one page of about 20 posts with no cursor.

Parameters and errors for each endpoint are in the Threads reference.

What it costs

Every Threads call costs 1 credit, so 1,000 profiles is 1,000 credits. You get 100 free credits a month; $19 buys 10,000 credits that never expire, and plans for higher volume cover more profiles. Get a free API key and run the request above.

We are not affiliated with Meta Platforms, Inc. or Threads.

Sources

Get this data from your own code

The Threads API returns it as JSON with one x-api-key header. 100 free credits monthly.