# API Direct – Search Threads Posts by Keyword

> API Direct – Search Threads Posts by Keyword 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).

Searches Meta's Threads platform for posts matching a given keyword, returning paginated results with optional AI sentiment analysis.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/threads/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-search-threads-posts-by-keyword-b27ad461
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Jgl8vh4_NL0CQWyxVlwlm

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-search-threads-posts-by-keyword-b27ad461
```

Example prompt: Search Threads for posts mentioning 'electric vehicles' — fetch 3 pages of results and include AI sentiment analysis for each post.

## When to prefer this

Use this endpoint when you need to search Meta's Threads platform specifically for posts matching a keyword. It is the right choice for brand monitoring, social listening, competitor research, or trend detection on Threads. Prefer it over Reddit or Twitter/X search endpoints when your target audience is on Threads. The optional sentiment analysis add-on makes it suitable for opinion mining without a separate NLP step.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Query exceeding 500 characters is rejected
- Pages value outside 1–200 range returns a validation error
- Keyword returns zero results if no matching Threads posts exist
- Rate limiting or upstream Threads API unavailability may cause failures
- Payment failure (insufficient USDC balance) blocks the request

## How this service works

Search for Threads posts by keyword.

## Output

Returns a paginated list of Threads posts matching the search keyword. Each page contains approximately 20 posts (first page) or 10 posts (subsequent pages), including post text and metadata. If sentiment analysis is enabled, each post also includes AI-generated emotion/sentiment scores. The agent 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": [
      "query"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 200,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-200 (default: 1). The first page returns about 20 posts and later pages about 10; you are billed per page returned."
      },
      "query": {
       "type": "string",
       "maxLength": 500,
       "description": "Search keyword (max 500 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-search-threads-posts-by-keyword-b27ad461/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)