# Threads Posts & Replies

> Threads Posts & Replies is a paid API for AI agents from social.duoleads.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Fetches the recent public posts and replies of a Threads account by handle or threads.com URL, returning text, engagement metrics, and author metadata.

## Facts

- Endpoint: GET https://social.duoleads.com/v1/threads/posts?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/threads-posts-replies-e2c283cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kgP6042oRmq4nbMdS1Xhw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability threads-posts-replies-e2c283cf
```

Example prompt: Pull the recent Threads posts from @natgeo — I want to see the text, likes, replies, and reposts for each one.

## When to prefer this

Choose this endpoint when you need structured post-level data (text, metrics, timestamps) for a specific known Threads account. It is ideal for content audits, influencer research, brand monitoring, and engagement analysis where you already know the account handle. Prefer this over a search endpoint when you want the full recent post history of one account rather than keyword-driven discovery. Bad or not-found inputs are not charged, making it safe for exploratory lookups.

## Known failure modes

- Handle not found or account does not exist — returns not-found response at no charge
- Invalid handle format provided — treated as bad input, returned free of charge
- Account is private or has no public posts — returns empty items array
- Rate limits or upstream provider issues — may return partial data or error
- Threads URL passed instead of handle not parsed correctly — may result in no match

## How this service works

Threads Posts & Replies: the recent public posts of one Threads account by handle or threads.com URL. Per post the text, likes, replies, reposts, time and URL, with the author's handle and verification, in the shared social schema. Bad input is free; not found or no match is not charged.

## Output

Returns a JSON object containing a list of recent public posts for the requested Threads account. Each post includes its ID, URL, text content, language, post type (post/reply), parent post ID for replies, creation timestamp, and engagement metrics (likes, replies, reposts, views). Author fields include handle, display name, verification status, and follower count where available. Also returns the query handle, pagination cursor, a completeness flag, and a disclaimer about data sourcing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "maxLength": 200,
       "description": "A Threads handle (with or without @) or a threads.com/@handle URL."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-15T12:00:00.000Z",
  "items": [
   {
    "id": "3650000000000000001",
    "url": "https://www.threads.com/@synthbrand/post/SYNthr001",
    "lang": null,
    "text": "Synthetic Threads post: we are testing a new feature",
    "type": "post",
    "author": {
     "handle": "synthbrand",
     "verified": true,
     "followers": null,
     "display_name": null
    },
    "metrics": {
     "likes": 964,
     "views": null,
     "replies": 31,
     "reposts": 12
    },
    "platform": "threads",
    "parent_id": null,
    "created_at": "2026-10-04T05:50:31.000Z",
    "media_urls": []
   }
  ],
  "query": {
   "handle": "synthbrand"
  },
  "source": "public data via third-party provider; not affiliated with the platform",
  "complete": true,
  "platform": "threads",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000",
  "next_cursor": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/threads-posts-replies-e2c283cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.duoleads.com](https://www.zero.xyz/host/social.duoleads.com/llms.txt)