POST

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

Look up as many as 20 Threads posts at once from urls, each a post link. Each post found is one row with text, author, like, comment, repost, quote, share and view counts, post time and media, plus input, the entry you passed. Billed per post; posts not found are not charged and come back in missed. An array with a duplicate, an unrecognized entry or more than 20 entries is rejected with a 422 before any charge.

Send POST https://api.everyinfra.com/api/v1/social with platform set to threads and action set to posts_batch. Price $0.56 per 1,000 requests ($0.000556 per call). Failed calls and empty results are not charged. Each element in urls counts as one call: the number of elements you send sets the charge. Synchronous only: everything it returns (every target of a batch, or every SKU of a product) is read within this call, and "mode": "async" returns a 422 before any charge.

AI prompt

#
Please help me write a data collection script with the EveryInfra Threads Posts in bulk endpoint (threads/posts_batch).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to threads and action to posts_batch, and put the parameters inside params.
- Required parameters:
  - urls: Threads post links for posts_batch, as an array of up to 20 entries; a comma-separated string is not accepted. Write each link as for post_detail. List each post once.
- Optional parameters:
  - limit: The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.
- Returns a list of records. Main fields of each record: id, code (Post code: the segment of the post link…), url, text, author_username, author_name, author_id, author_avatar_url (Author avatar URL), author_is_verified (Whether the author's account has a veri…), author_is_private (Whether the author's account is private), author_follower_count, like_count; 74 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Example request body:
{
  "platform": "threads",
  "action": "posts_batch",
  "params": {
    "urls": [
      "https://www.threads.com/@zuck/post/DfaNgswkQPG"
    ]
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- This endpoint runs synchronously only; do not add "mode": "async" to the body.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesthreadsPlatform identifier, fixed value.
actionbodystringYesposts_batchCapability identifier, fixed value.
urlsbody.paramsarrayYes-Threads post links for posts_batch, as an array of up to 20 entries; a comma-separated string is not accepted. Write each link as for post_detail. List each post once. A request with an unrecognized entry, a duplicate or more than 20 entries is rejected with a 422 before any charge. Billed per post; posts not found are not charged and are listed in missed.
limitbody.paramsinteger (1–)No-The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "threads",
  "action": "posts_batch",
  "params": {
    "urls": [
      "https://www.threads.com/@zuck/post/DfaNgswkQPG"
    ]
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "threads",  "action": "posts_batch",  "results": [    {      "id": …,      "code": …,      "url": …,      "text": …,      "author_username": …,      "author_name": …,      "author_id": …,      "author_avatar_url": …,      "author_is_verified": …,      "author_is_private": …,      "author_follower_count": …,      "like_count": …,      "comment_count": …,      "repost_count": …,      "quote_count": …,      "share_count": …,      "view_count": …,      "posted_at": …,      "media_type": …,      "image_count": …,      "video_count": …,      "media_url": …,      "video_duration_seconds": …,      "topic": …,      "topic_id": …,      "topic_name": …,      "topic_emoji": …,      "topic_is_community": …,      "language": …,      "is_edited": …,      "is_reply": …,      "reply_to_username": …,      "root_post_author_username": …,      "reply_level": …,      "is_pinned": …,      "is_pinned_by_author": …,      "is_spoiler": …,      "reply_control": …,      "counts_hidden": …,      "thread_id": …,      "thread_length": …,      "thread_position": …,      "is_federated": …,      "is_paid_partnership": …,      "ai_label": …,      "text_translation": …,      "attached_text": …,      "fediverse_like_count": …,      "fediverse_reply_count": …,      "is_liked_by_author": …,      "is_collapsed": …,      "reply_approval_enabled": …,      "is_ghost_post": …,      "ghost_expires_at": …,      "is_markup": …,      "hashtags": …,      "mentions": …,      "links": …,      "image_urls": …,      "video_urls": …,      "tagged_users": …,      "media": …,      "link_preview": …,      "location": …,      "quoted_post": …,      "reposted_post": …,      "gif": …,      "music": …,      "podcast": …,      "scorecard": …,      "trend": …,      "author_badge": …,      "custom_like": …,      "platform": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
codePost code: the segment of the post link that comes after /post/.
urlLink to the record on the platform.
textBody text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so).
author_usernameAuthor's username (@handle), usually usable in URLs.
author_nameAuthor's display name.
author_idAuthor's unique ID on the platform.
author_avatar_urlAuthor avatar URL; signed link that expires.
author_is_verifiedWhether the author's account has a verified badge.
author_is_privateWhether the author's account is private.
author_follower_countAuthor's follower count. null means not disclosed.
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countComments. null means not disclosed, not 0.
repost_countReposts (as distinct from quote posts). null means not disclosed.
quote_countQuotes: how many times others have quoted this post in their own posts. null means not disclosed, not 0.
share_countShares. null means not disclosed, not 0.
view_countViews or plays. null means not disclosed, not 0.
posted_atPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
media_typePost type: text (text only), image (one image), video (one video) or carousel (several images, or images and videos mixed).
image_countNumber of images.
video_countNumber of videos.
media_urlURL of the first attachment; signed link that expires.
video_duration_secondsDuration of the first video, in seconds; per-video durations are in duration_seconds on each media entry.
topicInternal name of the topic the post is attached to, e.g. bakingthreads; the display name is in topic_name.
topic_idID of the topic the post is attached to.
topic_nameDisplay name of the topic, e.g. Baking Threads.
topic_emojiEmoji icon of the topic (community).
topic_is_communityWhether the topic is a community.
languageContent language code (for example zh, en) as judged by the platform; it can be wrong.
is_editedWhether the post has been edited.
is_replyWhether this post is a reply.
reply_to_usernameUsername of the person this post replies to; absent when the post is not a reply.
root_post_author_usernameUsername of the author of the post at the top of this conversation.
reply_levelReply depth: 1 is a direct reply to the main post, 2 is a reply to a reply, and so on.
is_pinnedWhether the author pinned the post to their profile.
is_pinned_by_authorReplies only: whether the main post's author pinned it in the replies section.
is_spoilerWhether the post is marked with a spoiler overlay.
reply_controlWho can reply to this post, e.g. everyone.
counts_hiddenWhether the author hid the like and share counts; like_count is null when hidden.
thread_idID of the author's thread, the run of posts published in a row; posts in the same thread share this value.
thread_lengthNumber of posts in the author's thread; 1 when the post is not part of a thread.
thread_positionPosition of this post within the thread.
is_federatedWhether the post is synced to the fediverse.
is_paid_partnershipWhether the post is labeled as a paid partnership. Use it to identify ads.
ai_labelHow the post is labeled as AI-generated, e.g. SELF_DISCLOSURE_FLOW (labeled by the author); absent when there is none.
text_translationThreads' English translation of the text; present only when the text is not in English and Threads provides a translation.
attached_textFull text of the long-form text attachment on the post (the Threads text attachment).
fediverse_like_countLike count on the fediverse side (Mastodon and others).
fediverse_reply_countReply count on the fediverse side.
is_liked_by_authorReplies only: whether the main post's author liked this reply.
is_collapsedReplies only: the platform collapsed this reply. Present only when true.
reply_approval_enabledThe author turned on reply approval, so replies need approval first. Present only when true.
is_ghost_postThe post is a ghost post, a time-limited post that disappears automatically after a while. Present only when true.
ghost_expires_atTime when the ghost post disappears.
is_markupThe post is a Markup post, drawn or annotated on top of someone else's post. Present only when true.
hashtagsHashtags in the text, in order of appearance; absent when there are none.
mentionsUsernames @-mentioned in the text.
linksLinks in the text and links attached to the post.
image_urlsArray of image links in the platform's display order; absent when there are no images.
video_urlsURLs of all videos; signed links that expire.
tagged_usersUsernames of the people tagged in the images and videos.
mediaList of attachments, one entry each; absent when there are none. Each entry: type (image or video), url (file URL, signed link that expires), width and height (pixels), alt_text (alternative text, generated by Threads or written by the author); videos also carry thumbnail_url (cover image), has_audio (whether it has sound) and duration_seconds (length in seconds).
link_previewLink card: url, title (card title), description (card description), display_url (displayed domain), image_url (card image) and favicon_url (site favicon).
locationLocation attached to the post: id (location ID), name (location name) and url (this location's page on Threads).
quoted_postThe original post this post quotes: id, code, url, text, author_username and posted_at.
reposted_postThe original post this post reposts, with the same structure as quoted_post.
gifGIF in the post: url, webp_url (WebP-format URL), width and height (both in pixels).
musicMusic attached to the post: song_id, title (song title), artist, cover_url (cover image) and start_ms (millisecond of the song where playback starts); lyrics are not included.
podcastOn posts, the podcast episode card attached to the post: episode_name, episode_url, podcast_name, platform (podcast platform, e.g. SPOTIFY, APPLE) and image_url. In profile (account data), the podcast attached to the profile page: name, url, platform and image_url, and for some also links (listening links per platform, each with platform and url).
scorecardSports scorecard attached to the post: status (upcoming: not started, live: in progress, past: finished), starts_at (start time), clock (game clock), period (which period, e.g. Q4), home_team and away_team (each with name, short_name, score and logo_url) and url (link at the bottom of the card).
trendThe trend this post appears under: keyword (the trend's search term), id and summary (summary written by the platform; only some have it).
author_badgeThe author's badge in this community: type (badge type, e.g. MEMBER) and label (identity label the author chose in the community, e.g. a team name).
custom_likeCustom like style that replaces the default heart on this post: type (EMOJI or STICKER), emoji and sticker_url (sticker GIF URL).
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
inputprofiles_batch and posts_batch: the entry from the request that this row answers, returned exactly as you passed it.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

Google Analytics needs consent. Privacy