# Threads Posts in bulk API (threads.posts_batch)

- Canonical page: [https://everyinfra.com/en/threads-api/posts_batch](https://everyinfra.com/en/threads-api/posts_batch?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "threads", "action": "posts_batch", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Billing unit: each element in `urls` counts as one call; the number of elements you send sets the charge
- Returns: list
- Mode: sync only; everything it returns (every target of a batch, or every SKU of a product) is read in one call, and "mode": "async" returns 422 before any charge

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=threads&action=posts_batch

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| urls | not declared | yes | not declared | 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`. |
| limit | integer (1–) | no | not declared | 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. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| code | Post code: the segment of the post link that comes after /post/. |
| url | Link to the record on the platform. |
| text | Body 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_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| author_id | Author's unique ID on the platform. |
| author_avatar_url | Author avatar URL; signed link that expires. |
| author_is_verified | Whether the author's account has a verified badge. |
| author_is_private | Whether the author's account is private. |
| author_follower_count | Author's follower count. null means not disclosed. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| repost_count | Reposts (as distinct from quote posts). null means not disclosed. |
| quote_count | Quotes: how many times others have quoted this post in their own posts. null means not disclosed, not 0. |
| share_count | Shares. null means not disclosed, not 0. |
| view_count | Views or plays. null means not disclosed, not 0. |
| posted_at | Publish 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_type | Post type: text (text only), image (one image), video (one video) or carousel (several images, or images and videos mixed). |
| image_count | Number of images. |
| video_count | Number of videos. |
| media_url | URL of the first attachment; signed link that expires. |
| video_duration_seconds | Duration of the first video, in seconds; per-video durations are in duration_seconds on each media entry. |
| topic | Internal name of the topic the post is attached to, e.g. bakingthreads; the display name is in topic_name. |
| topic_id | ID of the topic the post is attached to. |
| topic_name | Display name of the topic, e.g. Baking Threads. |
| topic_emoji | Emoji icon of the topic (community). |
| topic_is_community | Whether the topic is a community. |
| language | Content language code (for example zh, en) as judged by the platform; it can be wrong. |
| is_edited | Whether the post has been edited. |
| is_reply | Whether this post is a reply. |
| reply_to_username | Username of the person this post replies to; absent when the post is not a reply. |
| root_post_author_username | Username of the author of the post at the top of this conversation. |
| reply_level | Reply depth: 1 is a direct reply to the main post, 2 is a reply to a reply, and so on. |
| is_pinned | Whether the author pinned the post to their profile. |
| is_pinned_by_author | Replies only: whether the main post's author pinned it in the replies section. |
| is_spoiler | Whether the post is marked with a spoiler overlay. |
| reply_control | Who can reply to this post, e.g. everyone. |
| counts_hidden | Whether the author hid the like and share counts; like_count is null when hidden. |
| thread_id | ID of the author's thread, the run of posts published in a row; posts in the same thread share this value. |
| thread_length | Number of posts in the author's thread; 1 when the post is not part of a thread. |
| thread_position | Position of this post within the thread. |
| is_federated | Whether the post is synced to the fediverse. |
| is_paid_partnership | Whether the post is labeled as a paid partnership. Use it to identify ads. |
| ai_label | How the post is labeled as AI-generated, e.g. SELF_DISCLOSURE_FLOW (labeled by the author); absent when there is none. |
| text_translation | Threads' English translation of the text; present only when the text is not in English and Threads provides a translation. |
| attached_text | Full text of the long-form text attachment on the post (the Threads text attachment). |
| fediverse_like_count | Like count on the fediverse side (Mastodon and others). |
| fediverse_reply_count | Reply count on the fediverse side. |
| is_liked_by_author | Replies only: whether the main post's author liked this reply. |
| is_collapsed | Replies only: the platform collapsed this reply. Present only when true. |
| reply_approval_enabled | The author turned on reply approval, so replies need approval first. Present only when true. |
| is_ghost_post | The post is a ghost post, a time-limited post that disappears automatically after a while. Present only when true. |
| ghost_expires_at | Time when the ghost post disappears. |
| is_markup | The post is a Markup post, drawn or annotated on top of someone else's post. Present only when true. |
| hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
| mentions | Usernames @-mentioned in the text. |
| links | Links in the text and links attached to the post. |
| image_urls | Array of image links in the platform's display order; absent when there are no images. |
| video_urls | URLs of all videos; signed links that expire. |
| tagged_users | Usernames of the people tagged in the images and videos. |
| media | List 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_preview | Link card: url, title (card title), description (card description), display_url (displayed domain), image_url (card image) and favicon_url (site favicon). |
| location | Location attached to the post: id (location ID), name (location name) and url (this location's page on Threads). |
| quoted_post | The original post this post quotes: id, code, url, text, author_username and posted_at. |
| reposted_post | The original post this post reposts, with the same structure as quoted_post. |
| gif | GIF in the post: url, webp_url (WebP-format URL), width and height (both in pixels). |
| music | Music 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. |
| podcast | On 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). |
| scorecard | Sports 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). |
| trend | The trend this post appears under: keyword (the trend's search term), id and summary (summary written by the platform; only some have it). |
| author_badge | The 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_like | Custom like style that replaces the default heart on this post: type (EMOJI or STICKER), emoji and sticker_url (sticker GIF URL). |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| input | profiles_batch and posts_batch: the entry from the request that this row answers, returned exactly as you passed it. |

## Example

```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"
    ]
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "threads",
        "action": "posts_batch",
        "params": {
            "urls": [
                "https://www.threads.com/@zuck/post/DfaNgswkQPG",
            ],
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "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": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=threads
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
