X/Twitter API: 搜索 — 按查询获取帖子

此端点的作用

利用此 API 方法可以构建什么

先查看结果和常见工作流，然后再了解参数和可运行的请求示例。

此端点可以帮助您

响应包含匹配的搜索、公开上下文，以及在有更多结果时的分页数据。

何时使用

当不知道确切的对象 ID、需要先找到相关候选项时，请使用“按查询获取帖子”。

常见使用场景

产品内搜索

在面向客户的界面和内部界面中加入 X/Twitter 数据搜索。

构建目录

按查询查找候选项，并保存相关对象以供后续补全。

市场研究

收集结果集，用于主题、创作者和竞品分析。

可用版本

响应版本

两个版本完成相同的任务，接受相同的参数。使用切换按钮比较响应结构，并选择您的客户端所需的版本。

响应版本 V2

在本页面切换版本，即可在同一文档 URL 下比较响应结构。

保持不变的部分

V1 和 V2 的身份验证、必填参数和请求结构均相同。实际上，您只需在构建端点路径和解析响应时选择版本。

版本之间的差异

主要区别在于响应结构。新集成请使用 V2；仅在需要兼容现有客户端契约时保留 V1。

使用方法

如何调用该方法

两个版本使用相同的 API 密钥请求头和相同的查询参数。本文档先展示共享的参数集合，然后展示各版本特定的端点路径和代码片段。

输入参数

共享参数

参数	必填	类型	示例	说明
`query`	是	`str`	`technology`	用户输入的搜索关键词。
`all_of_these_words`	否	`str \| None`	`AI robotics`	Optional words that must all appear in matching Twitter/X posts. Example: AI robotics.
`any_of_these_words`	否	`str \| None`	`launch release`	Optional words where any one may appear in matching Twitter/X posts. Example: launch release.
`cursor`	否	`str \| None`	`DAABCgABF4ABCD...`	上一次响应返回的下一页游标。获取第一页时请省略。
`exact_phrase`	否	`str \| None`	`machine learning`	Optional exact phrase that must appear in matching Twitter/X posts. Example: machine learning.
`from_accounts`	否	`str \| None`	`technews xai`	Optional source accounts without or with @, separated by spaces or commas. Example: technews xai.
`hashtags`	否	`str \| None`	`#TechNews #AI`	Optional hashtags to require, separated by spaces or commas. Example: #TechNews #AI.
`language`	否	`str \| None`	`en`	Optional Twitter/X language code. Use 'any' to omit language filtering. Example: en.
`link_filter`	否	`include \| only \| exclude \| None`	`only`	Optional link filter: include all posts, only posts with links, or exclude links. Example: only.
`mentioning_accounts`	否	`str \| None`	`technews elonmusk`	Optional mentioned accounts without or with @, separated by spaces or commas. Example: technews elonmusk.
`min_likes`	否	`int \| None`	`100`	Optional minimum like count. Example: 100.
`min_replies`	否	`int \| None`	`10`	Optional minimum reply count. Example: 10.
`min_retweets`	否	`int \| None`	`25`	Optional minimum repost/retweet count. Example: 25.
`none_of_these_words`	否	`str \| None`	`rumor leak`	Optional words to exclude from matching Twitter/X posts. Example: rumor leak.
`reply_filter`	否	`include \| only \| exclude \| None`	`exclude`	Optional reply filter: include all posts, only replies, or exclude replies. Example: exclude.
`since_date`	否	`date \| None`	`2026-01-01`	Optional earliest post date in ISO YYYY-MM-DD format. Example: 2026-01-01.
`tag`	否	`Top \| Latest \| People \| Photos \| Videos \| None`	`Latest`	Optional Twitter/X search product filter. Example: Latest.
`to_accounts`	否	`str \| None`	`technews`	Optional reply target accounts without or with @, separated by spaces or commas. Example: technews.
`until_date`	否	`date \| None`	`2026-01-31`	Optional latest post date in ISO YYYY-MM-DD format. Example: 2026-01-31.

各版本的请求路径

V2

复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。

GET /api/v2/twitter.com/search/tweets-by-query

规范化格式

请求预览

基础 URL https://www.scrapestorm.net

端点 /api/v2/twitter.com/search/tweets-by-query

必填参数

query

可选参数

all_of_these_words any_of_these_words cursor exact_phrase from_accounts hashtags language link_filter mentioning_accounts min_likes min_replies min_retweets none_of_these_words reply_filter since_date tag to_accounts until_date

示例 URL

https://www.scrapestorm.net/api/v2/twitter.com/search/tweets-by-query?query=technology

代码示例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/twitter.com/search/tweets-by-query" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'query=technology' \
  # Optional parameters:
  # --data-urlencode 'all_of_these_words=AI robotics'
  # --data-urlencode 'any_of_these_words=launch release'
  # --data-urlencode 'cursor=DAABCgABF4ABCD...'
  # --data-urlencode 'exact_phrase=machine learning'
  # --data-urlencode 'from_accounts=technews xai'
  # --data-urlencode 'hashtags=#TechNews #AI'
  # --data-urlencode 'language=en'
  # --data-urlencode 'link_filter=only'
  # --data-urlencode 'mentioning_accounts=technews elonmusk'
  # --data-urlencode 'min_likes=100'
  # --data-urlencode 'min_replies=10'
  # --data-urlencode 'min_retweets=25'
  # --data-urlencode 'none_of_these_words=rumor leak'
  # --data-urlencode 'reply_filter=exclude'
  # --data-urlencode 'since_date=2026-01-01'
  # --data-urlencode 'tag=Latest'
  # --data-urlencode 'to_accounts=technews'
  # --data-urlencode 'until_date=2026-01-31'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/twitter.com/search/tweets-by-query"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "query": "technology",
}

# Optional parameters
# params["all_of_these_words"] = "AI robotics"
# params["any_of_these_words"] = "launch release"
# params["cursor"] = "DAABCgABF4ABCD..."
# params["exact_phrase"] = "machine learning"
# params["from_accounts"] = "technews xai"
# params["hashtags"] = "#TechNews #AI"
# params["language"] = "en"
# params["link_filter"] = "only"
# params["mentioning_accounts"] = "technews elonmusk"
# params["min_likes"] = "100"
# params["min_replies"] = "10"
# params["min_retweets"] = "25"
# params["none_of_these_words"] = "rumor leak"
# params["reply_filter"] = "exclude"
# params["since_date"] = "2026-01-01"
# params["tag"] = "Latest"
# params["to_accounts"] = "technews"
# params["until_date"] = "2026-01-31"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/twitter.com/search/tweets-by-query";

const params = new URLSearchParams({
  query: "technology",
});

// Optional parameters
// params.set("all_of_these_words", "AI robotics");
// params.set("any_of_these_words", "launch release");
// params.set("cursor", "DAABCgABF4ABCD...");
// params.set("exact_phrase", "machine learning");
// params.set("from_accounts", "technews xai");
// params.set("hashtags", "#TechNews #AI");
// params.set("language", "en");
// params.set("link_filter", "only");
// params.set("mentioning_accounts", "technews elonmusk");
// params.set("min_likes", "100");
// params.set("min_replies", "10");
// params.set("min_retweets", "25");
// params.set("none_of_these_words", "rumor leak");
// params.set("reply_filter", "exclude");
// params.set("since_date", "2026-01-01");
// params.set("tag", "Latest");
// params.set("to_accounts", "technews");
// params.set("until_date", "2026-01-31");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  query: "technology",
};

// Optional parameters
// params.all_of_these_words = "AI robotics";
// params.any_of_these_words = "launch release";
// params.cursor = "DAABCgABF4ABCD...";
// params.exact_phrase = "machine learning";
// params.from_accounts = "technews xai";
// params.hashtags = "#TechNews #AI";
// params.language = "en";
// params.link_filter = "only";
// params.mentioning_accounts = "technews elonmusk";
// params.min_likes = "100";
// params.min_replies = "10";
// params.min_retweets = "25";
// params.none_of_these_words = "rumor leak";
// params.reply_filter = "exclude";
// params.since_date = "2026-01-01";
// params.tag = "Latest";
// params.to_accounts = "technews";
// params.until_date = "2026-01-31";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "query" => "technology",
];

// Optional parameters
// $query["all_of_these_words"] = "AI robotics";
// $query["any_of_these_words"] = "launch release";
// $query["cursor"] = "DAABCgABF4ABCD...";
// $query["exact_phrase"] = "machine learning";
// $query["from_accounts"] = "technews xai";
// $query["hashtags"] = "#TechNews #AI";
// $query["language"] = "en";
// $query["link_filter"] = "only";
// $query["mentioning_accounts"] = "technews elonmusk";
// $query["min_likes"] = "100";
// $query["min_replies"] = "10";
// $query["min_retweets"] = "25";
// $query["none_of_these_words"] = "rumor leak";
// $query["reply_filter"] = "exclude";
// $query["since_date"] = "2026-01-01";
// $query["tag"] = "Latest";
// $query["to_accounts"] = "technews";
// $query["until_date"] = "2026-01-31";

try {
    $response = $client->request("GET", "/api/v2/twitter.com/search/tweets-by-query", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/twitter.com/search/tweets-by-query"

    params := url.Values{}
    params.Set("query", "technology")

    // Optional parameters
    // params.Set("until_date", "2026-01-31")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

各版本的请求路径

V1

复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。

GET /api/v1/twitter.com/search/tweets-by-query

平台原生格式

请求预览

基础 URL https://www.scrapestorm.net

端点 /api/v1/twitter.com/search/tweets-by-query

必填参数

query

可选参数

all_of_these_words any_of_these_words cursor exact_phrase from_accounts hashtags language link_filter mentioning_accounts min_likes min_replies min_retweets none_of_these_words reply_filter since_date tag to_accounts until_date

示例 URL

https://www.scrapestorm.net/api/v1/twitter.com/search/tweets-by-query?query=technology

代码示例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/twitter.com/search/tweets-by-query" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'query=technology' \
  # Optional parameters:
  # --data-urlencode 'all_of_these_words=AI robotics'
  # --data-urlencode 'any_of_these_words=launch release'
  # --data-urlencode 'cursor=DAABCgABF4ABCD...'
  # --data-urlencode 'exact_phrase=machine learning'
  # --data-urlencode 'from_accounts=technews xai'
  # --data-urlencode 'hashtags=#TechNews #AI'
  # --data-urlencode 'language=en'
  # --data-urlencode 'link_filter=only'
  # --data-urlencode 'mentioning_accounts=technews elonmusk'
  # --data-urlencode 'min_likes=100'
  # --data-urlencode 'min_replies=10'
  # --data-urlencode 'min_retweets=25'
  # --data-urlencode 'none_of_these_words=rumor leak'
  # --data-urlencode 'reply_filter=exclude'
  # --data-urlencode 'since_date=2026-01-01'
  # --data-urlencode 'tag=Latest'
  # --data-urlencode 'to_accounts=technews'
  # --data-urlencode 'until_date=2026-01-31'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/twitter.com/search/tweets-by-query"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "query": "technology",
}

# Optional parameters
# params["all_of_these_words"] = "AI robotics"
# params["any_of_these_words"] = "launch release"
# params["cursor"] = "DAABCgABF4ABCD..."
# params["exact_phrase"] = "machine learning"
# params["from_accounts"] = "technews xai"
# params["hashtags"] = "#TechNews #AI"
# params["language"] = "en"
# params["link_filter"] = "only"
# params["mentioning_accounts"] = "technews elonmusk"
# params["min_likes"] = "100"
# params["min_replies"] = "10"
# params["min_retweets"] = "25"
# params["none_of_these_words"] = "rumor leak"
# params["reply_filter"] = "exclude"
# params["since_date"] = "2026-01-01"
# params["tag"] = "Latest"
# params["to_accounts"] = "technews"
# params["until_date"] = "2026-01-31"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/twitter.com/search/tweets-by-query";

const params = new URLSearchParams({
  query: "technology",
});

// Optional parameters
// params.set("all_of_these_words", "AI robotics");
// params.set("any_of_these_words", "launch release");
// params.set("cursor", "DAABCgABF4ABCD...");
// params.set("exact_phrase", "machine learning");
// params.set("from_accounts", "technews xai");
// params.set("hashtags", "#TechNews #AI");
// params.set("language", "en");
// params.set("link_filter", "only");
// params.set("mentioning_accounts", "technews elonmusk");
// params.set("min_likes", "100");
// params.set("min_replies", "10");
// params.set("min_retweets", "25");
// params.set("none_of_these_words", "rumor leak");
// params.set("reply_filter", "exclude");
// params.set("since_date", "2026-01-01");
// params.set("tag", "Latest");
// params.set("to_accounts", "technews");
// params.set("until_date", "2026-01-31");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  query: "technology",
};

// Optional parameters
// params.all_of_these_words = "AI robotics";
// params.any_of_these_words = "launch release";
// params.cursor = "DAABCgABF4ABCD...";
// params.exact_phrase = "machine learning";
// params.from_accounts = "technews xai";
// params.hashtags = "#TechNews #AI";
// params.language = "en";
// params.link_filter = "only";
// params.mentioning_accounts = "technews elonmusk";
// params.min_likes = "100";
// params.min_replies = "10";
// params.min_retweets = "25";
// params.none_of_these_words = "rumor leak";
// params.reply_filter = "exclude";
// params.since_date = "2026-01-01";
// params.tag = "Latest";
// params.to_accounts = "technews";
// params.until_date = "2026-01-31";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "query" => "technology",
];

// Optional parameters
// $query["all_of_these_words"] = "AI robotics";
// $query["any_of_these_words"] = "launch release";
// $query["cursor"] = "DAABCgABF4ABCD...";
// $query["exact_phrase"] = "machine learning";
// $query["from_accounts"] = "technews xai";
// $query["hashtags"] = "#TechNews #AI";
// $query["language"] = "en";
// $query["link_filter"] = "only";
// $query["mentioning_accounts"] = "technews elonmusk";
// $query["min_likes"] = "100";
// $query["min_replies"] = "10";
// $query["min_retweets"] = "25";
// $query["none_of_these_words"] = "rumor leak";
// $query["reply_filter"] = "exclude";
// $query["since_date"] = "2026-01-01";
// $query["tag"] = "Latest";
// $query["to_accounts"] = "technews";
// $query["until_date"] = "2026-01-31";

try {
    $response = $client->request("GET", "/api/v1/twitter.com/search/tweets-by-query", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v1/twitter.com/search/tweets-by-query"

    params := url.Values{}
    params.Set("query", "technology")

    // Optional parameters
    // params.Set("until_date", "2026-01-31")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

响应示例

按版本查看真实响应

预览保留了关键字段和集合中的前几项，便于您快速浏览响应结构。切换版本会改变 JSON 格式。

响应示例

V2 响应 JSON

已验证示例

此简明 JSON 示例来自 V2 最近一次成功的验证运行。

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "query": "Python code",
    "tag": "Top"
  },
  "data": {
    "tweets": {
      "count": 20,
      "items": [
        {
          "url": "https://x.com/freeCodeCamp/status/2078389573567050090",
          "tweet_id": "2078389573567050090",
          "text": "Learning to code can feel overwhelming when you don't know where to start.\n\nSo here's a course for you: Sunny teaches you Python from the ground up.\n\nYou'll install Python, writ…",
          "hashtags": [],
          "emails": [],
          "created_at": "2026-07-18T08:01:03Z",
          "language": "en",
          "source": "Buffer",
          "author": {
            "url": "https://x.com/freeCodeCamp",
            "user_id": "1668100142",
            "username": "freeCodeCamp",
            "display_name": "freeCodeCamp.org",
            "description": "We're a community of millions of people who are building new skills and getting new jobs together. A 501(c)(3) public charity. Tweets by @abbeyrenn.",
            "emails": [],
            "external_links": [],
            "location": "Just here on Earth... for now",
            "created_at": "2013-08-13T15:27:51Z",
            "is_verified": false,
            "is_blue_verified": true,
            "is_protected": false,
            "possibly_sensitive": false,
            "default_profile": false,
            "default_profile_image": false,
            "followers_count": 1204998,
            "following_count": 159,
            "tweet_count": 36772,
            "media_count": 5153,
            "listed_count": 6833,
            "like_count": 72305,
            "professional_type": null,
            "professional_category_name": null,
            "affiliated_account": null,
            "_more_fields": "5 more fields"
          },
          "is_from_automated_account": null,
          "media": {
            "images": [
              "…"
            ],
            "videos": [],
            "gifs": []
          },
          "external_links": [],
          "user_mentions": [],
          "is_reply": false,
          "reply": null,
          "is_quote": false,
          "quote_tweet_id": null,
          "is_retweet": false,
          "retweeted_tweet_id": null,
          "reply_count": 4,
          "retweet_count": 108,
          "quote_count": 3,
          "like_count": 599,
          "bookmark_count": 455,
          "_more_fields": "2 more fields"
        },
        {
          "url": "https://x.com/PythonPr/status/2078910492068786514",
          "tweet_id": "2078910492068786514",
          "text": "Pyramids in Python Code Examples for Beginners ⭐ https://t.co/QngwbiMVkb",
          "hashtags": [],
          "emails": [],
          "created_at": "2026-07-19T18:31:00Z",
          "language": "en",
          "source": "Twitter Web App",
          "author": {
            "url": "https://x.com/PythonPr",
            "user_id": "855384627975831553",
            "username": "PythonPr",
            "display_name": "Python Programming",
            "description": "#python #programming",
            "emails": [],
            "external_links": [],
            "location": "United States",
            "created_at": "2017-04-21T11:36:02Z",
            "is_verified": false,
            "is_blue_verified": true,
            "is_protected": false,
            "possibly_sensitive": false,
            "default_profile": true,
            "default_profile_image": false,
            "followers_count": 208924,
            "following_count": 1162,
            "tweet_count": 9883,
            "media_count": 4108,
            "listed_count": 1243,
            "like_count": 20597,
            "professional_type": null,
            "professional_category_name": null,
            "affiliated_account": null,
            "_more_fields": "5 more fields"
          },
          "is_from_automated_account": null,
          "media": {
            "images": [
              "…"
            ],
            "videos": [],
            "gifs": []
          },
          "external_links": [],
          "user_mentions": [],
          "is_reply": false,
          "reply": null,
          "is_quote": false,
          "quote_tweet_id": null,
          "is_retweet": false,
          "retweeted_tweet_id": null,
          "reply_count": 3,
          "retweet_count": 8,
          "quote_count": 0,
          "like_count": 62,
          "bookmark_count": 39,
          "_more_fields": "2 more fields"
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}

响应示例

V1 响应 JSON

已验证示例

此简明 JSON 示例来自 V1 最近一次成功的验证运行。

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "tag": "Top",
    "query": "Python code"
  },
  "data": {
    "data": {
      "search_by_raw_query": {
        "search_timeline": {
          "timeline": {
            "instructions": [
              "…"
            ],
            "responseObjects": {
              "feedbackActions": "…"
            }
          }
        }
      }
    }
  }
}

继续处理搜索

相邻的方法可让您用其他标识符解析同一对象、打开详情或转到汇总视图。

下一步

继续评估

将本文档作为第一个决策点，然后在将端点接入常规使用之前，继续了解价格、平台覆盖范围和集成规则。

打开 X/Twitter 平台页面

在实现之前，比较相邻的实体、API 方法分组和相关文档。

打开平台页面

比较 API 方法价格

在扩大使用规模之前，查看此 API 方法在公开价格表中的位置。

查看价格

查看集成规则

通过入门文档确认身份验证、版本管理、重试以及模拟环境与正式环境的差异。

打开文档

常见问题

团队在实现前常问的问题

借助这些解答，判断此 API 方法是否适合您的工作流、版本选择和上线计划。

此 X/Twitter API 方法返回哪些数据？

该方法针对搜索执行“按查询获取帖子”操作。下方的简明响应示例展示了确切的字段结构。

应该选择 V1 还是 V2？

新集成请选择 V2，因为它提供规范化的结构。仅在兼容已使用平台原生格式的客户端时使用 V1。

第一个请求需要准备什么？

创建 API 密钥，在请求头中发送它，并提供表格中的必填参数。代码示例中已包含正确的路径和请求结构。

X/Twitter API: 搜索 — 按查询获取帖子

利用此 API 方法可以构建什么

此端点可以帮助您

何时使用

常见使用场景

产品内搜索

构建目录

市场研究

响应版本

保持不变的部分

版本之间的差异

如何调用该方法

输入参数

各版本的请求路径

代码示例

各版本的请求路径

代码示例

按版本查看真实响应

V2 响应 JSON

V1 响应 JSON

继续处理搜索

搜索: 按地点名称获取场所

搜索: 按地点 ID 获取热门趋势

继续评估

打开 X/Twitter 平台页面

比较 API 方法价格

查看集成规则

团队在实现前常问的问题