Threads 帖子搜索 API

curl -G "https://api.dataxapi.com/v1/threads/posts/search" \
  --data-urlencode "query=nasa" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

{
  "code": "ok",
  "request_id": "e29e0cba-d1da-4448-a7fa-8bee6608fc4e",
  "data": {
    "items": [
      {
        "id": "DAFGOBWKcB_",
        "url": "https://www.threads.com/@fieldnotes_studio/post/DAFGOBWKcB_",
        "type": "image",
        "text": "Everything I wish I knew about nasa before starting.",
        "published_at": "2025-03-07T01:13:54.000Z",
        "author": {
          "id": "56049947906",
          "username": "fieldnotes_studio",
          "name": "Field Notes Studio",
          "avatar_url": "https://scontent.cdninstagram.com/v/t51.2885-19/492990253_10899382458156062_n.jpg",
          "verified": true
        },
        "metrics": {
          "likes": 43152,
          "comments": 3630,
          "shares": 1775,
          "reposts": 3369
        },
        "images": [
          "https://scontent.cdninstagram.com/v/t51.29350-15/482950892_19970165314554455_n.jpg"
        ],
        "hashtags": [],
        "is_pinned": null
      },
      // … 另有 18 条
    ]
  },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 19
  },
  "warnings": [],
  "meta": {
    "capability": "threads.posts.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T19:14:46.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "title": "platform",
      "lang": "capability",
      "author.followers": "capability",
      "metrics.favorites": "platform",
      "metrics.views": "capability",
      "mentions": "capability",
      "post_id": "capability",
      "parent_id": "capability",
      "root_id": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

取自 2026-10-12 19:14 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

返回大小：标准档 21.6 KB（精简 8.0 KB，完整 22.5 KB）。

{
  "code": "ok",
  "request_id": "cfa3f7e1-0b26-4d5f-a5a5-c5afc2786515",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "threads.posts.search",
    "result_status": "empty",
    "fetched_at": "2026-10-12T18:42:51.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "title": "platform",
      "lang": "capability",
      "author.followers": "capability",
      "metrics.favorites": "platform",
      "metrics.views": "capability",
      "mentions": "capability",
      "post_id": "capability",
      "parent_id": "capability",
      "root_id": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

取自 2026-10-12 18:42 UTC 录下的真实返回。请求号和余额是示意。

返回大小：标准档 628 B（精简 628 B，完整 628 B）。

curl -G "https://api.dataxapi.com/v1/threads/posts/search" \
  --data-urlencode "query=nasa" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.threads.posts.search(query="nasa")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.threads.posts.search({ query: "nasa" });
console.log(result.data.items);

dataxapi call threads.posts.search query=nasa

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

把这段加进你的 MCP 客户端，然后让你的 AI 调用 threads.posts.search。