# API Direct – Threads User Posts Feed

> API Direct – Threads User Posts Feed is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Fetches a Threads user's recent posts (their feed) by username, optionally with AI sentiment analysis.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/threads/user/posts?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-threads-user-posts-feed-fb7c7c6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aJ8U3W1ML_2p_KNySeepR

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 api-direct-threads-user-posts-feed-fb7c7c6a
```

Example prompt: Pull the last 2 pages of recent Threads posts from @zuck — so about 70 posts newest first — and include the AI sentiment analysis for each one.

## When to prefer this

Choose this endpoint when you need to programmatically retrieve a specific Threads user's recent post history by username, especially for social listening, competitive research, content auditing, or monitoring a creator's activity over time. It supports multi-page fetching (up to ~2,100 posts across 60 pages) and optional AI sentiment enrichment per post, making it suitable for both quick snapshots and deeper historical pulls. Prefer it over manual browsing or general social scraping tools when you need structured, paginated Threads feed data with an optional emotional tone layer.

## Known failure modes

- Username not found or account doesn't exist — likely a 404 or empty result
- Private or restricted Threads account — posts not accessible
- Invalid username format — validation error
- Pages parameter out of range (must be 1–60) — schema validation error
- Rate limiting or upstream Threads API unavailability — 5xx error
- Billing/payment failure via x402 protocol — 402 Payment Required

## How this service works

Get a single Threads user's recent posts (their feed) by username.

## Output

Returns a paginated list of recent Threads posts for the specified user, ordered newest first. Each page contains up to ~35 posts. When sentiment analysis is enabled (get_sentiment=true), each post also includes AI-generated emotion/sentiment scores. The caller is billed per page returned.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "username"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 60,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-60 (default: 1). Each page returns up to about 35 posts, newest first; you are billed per page returned."
      },
      "username": {
       "type": "string",
       "maxLength": 100,
       "description": "Threads username, with or without leading @ (max 100 characters)"
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to add AI emotion analysis to each result (+$0.001/request)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-threads-user-posts-feed-fb7c7c6a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)