X/Twitter API: Поиск — Посты по запросу

Что делает этот эндпоинт

Что можно сделать с этим API-методом

Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.

Результат запроса

Ответ содержит найденные объекты «Поиск», их публичный контекст и данные для продолжения поиска, если доступна пагинация.

Когда использовать

Операция «Посты по запросу» нужна, когда точный ID объекта ещё неизвестен и сначала требуется найти подходящие результаты.

Типовые сценарии использования

Поиск в продукте

Добавляйте поиск по данным X/Twitter в клиентский или внутренний интерфейс.

Формирование каталога

Находите кандидатов по запросам и сохраняйте релевантные объекты для дальнейшего обогащения.

Исследование рынка

Собирайте поисковую выдачу для анализа тем, авторов и конкурентного окружения.

Доступные версии

Версия ответа

Обе версии решают одну и ту же задачу и принимают одинаковые параметры. Переключатель нужен, чтобы сравнить структуру ответа и выбрать версию, которую ожидает ваш клиент.

Версия ответа V2

Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.

Что остается одинаковым

Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.

Что меняется между версиями

Главное отличие — envelope ответа. Для новых интеграций лучше использовать 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

Пример ссылки

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

Пример ссылки

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/clcoding/status/1698437458546028664",
          "tweet_id": "1698437458546028664",
          "text": "What is the output of the following Python code? #coding #python #pythonquiz https://t.co/NbrvId3g4W",
          "hashtags": [
            "coding",
            "python",
            {
              "_more_items": 1
            }
          ],
          "emails": [],
          "created_at": "2023-09-03T20:47:00Z",
          "language": "en",
          "source": null,
          "author": {
            "url": "https://x.com/clcoding",
            "user_id": "1322566336367636482",
            "username": "clcoding",
            "display_name": "Python Coding",
            "description": "Lets Learn #Python with tips and tricks. Free Python Course: https://t.co/l9NKxZWrh7 biz : [email protected] AI Community Partner. DM for Everything.",
            "emails": [
              "[email protected]"
            ],
            "external_links": [
              "…"
            ],
            "location": "Earth🌎",
            "created_at": "2020-10-31T15:49:39Z",
            "is_verified": false,
            "is_blue_verified": true,
            "is_protected": false,
            "possibly_sensitive": false,
            "default_profile": true,
            "default_profile_image": false,
            "followers_count": 654700,
            "following_count": 155,
            "tweet_count": 17608,
            "media_count": 12272,
            "listed_count": 3166,
            "like_count": 1068,
            "professional_type": "Creator",
            "professional_category_name": [
              "Education"
            ],
            "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": 209,
          "retweet_count": 108,
          "quote_count": 7,
          "like_count": 1035,
          "bookmark_count": 91,
          "_more_fields": "2 more fields"
        },
        {
          "url": "https://x.com/PythonPr/status/2109611213974028338",
          "tweet_id": "2109611213974028338",
          "text": "VS Code isn't disappearing, it's just evolving. https://t.co/ffQkOQEjfJ",
          "hashtags": [],
          "emails": [],
          "created_at": "2026-10-12T11:44:42Z",
          "language": "en",
          "source": null,
          "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": 221500,
            "following_count": 1161,
            "tweet_count": 10712,
            "media_count": 4805,
            "listed_count": 1268,
            "like_count": 23751,
            "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": 13,
          "retweet_count": 22,
          "quote_count": 3,
          "like_count": 282,
          "bookmark_count": 60,
          "_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": "…"
            }
          }
        }
      }
    }
  }
}

Связанные методы

Другие методы: Поиск

Соседние методы помогают получить тот же объект по другому идентификатору, открыть детали или перейти к агрегированной сводке.

Что делать дальше

Продолжить оценку API-метода

Используйте инструкцию как первую точку принятия решения, а затем переходите к покрытию, стоимости и общим правилам интеграции перед запуском API-метода.

Открыть страницу X/Twitter API

Сравните соседние сущности, группы API-методов и связанные инструкции перед внедрением.

Открыть страницу платформы

Сравнить стоимость API-методов

Посмотрите, где этот API-метод находится в публичной таблице цен, прежде чем масштабировать использование.

Открыть тарифы

Проверить правила интеграции

Откройте стартовую документацию, чтобы быстро проверить аутентификацию, версионирование, повторы запросов и различия между тестовым и рабочим API.

Открыть документацию

FAQ

Вопросы, которые команды задают до внедрения

Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.

Какие данные возвращает этот метод X/Twitter API?

Метод выполняет операцию «Посты по запросу» для сущности «Поиск». Точный набор полей показан в компактном примере ответа ниже.

Какую версию ответа выбрать: V1 или V2?

Для новой интеграции выбирайте V2 с нормализованной структурой. V1 нужен только для совместимости с клиентами, которые уже используют исходный формат платформы.

Что нужно для первого запроса?

Создайте API-ключ, передайте его в заголовке и заполните обязательные параметры из таблицы. Готовые примеры кода уже содержат правильный путь и структуру запроса.

X/Twitter API: Поиск — Посты по запросу

Что можно сделать с этим API-методом

Результат запроса

Когда использовать

Типовые сценарии использования

Поиск в продукте

Формирование каталога

Исследование рынка

Версия ответа

Что остается одинаковым

Что меняется между версиями

Как вызвать метод

Входные параметры

Путь запроса для выбранной версии

Примеры кода

Путь запроса для выбранной версии

Примеры кода

Пример ответа по версиям

V2 — JSON

V1 — JSON

Другие методы: Поиск

Поиск: Место по названию локации

Поиск: Тренды по place ID

Продолжить оценку API-метода

Открыть страницу X/Twitter API

Сравнить стоимость API-методов

Проверить правила интеграции

Вопросы, которые команды задают до внедрения