Recent Search クイックスタート

このガイドでは、直近 7 日間の投稿を検索する初回の recent search リクエストの手順を説明します。

前提条件始める前に以下が必要です:

承認済みの App を含む開発者アカウント
App の Bearer Token(Developer Console の「Keys and tokens」で確認できます)

クエリを組み立てる

検索クエリは演算子を使って投稿にマッチします。シンプルなキーワードから始めます:

python

または複数の演算子を組み合わせます:

python lang:en -is:retweet

これは、リツイートを除く、英語で “python” を含む投稿にマッチします。

利用可能なすべてのオプションは完全な演算子リファレンスを参照してください。

リクエストを実行する

cURL

curl "https://api.x.com/2/tweets/search/recent?query=python%20lang%3Aen%20-is%3Aretweet" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Recent Posts を検索
for page in client.posts.search_recent(
    query="python lang:en -is:retweet"
):
    for post in page.data:
        print(post.text)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Recent Posts を検索
const paginator = client.posts.searchRecent({
  query: "python lang:en -is:retweet",
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

レスポンスを確認する

デフォルトレスポンスには id、text、edit_history_tweet_ids が含まれます:

{
  "data": [
    {
      "id": "1234567890123456789",
      "text": "Just started learning Python and loving it!",
      "edit_history_tweet_ids": ["1234567890123456789"]
    },
    {
      "id": "1234567890123456788",
      "text": "Python tip: use list comprehensions for cleaner code",
      "edit_history_tweet_ids": ["1234567890123456788"]
    }
  ],
  "meta": {
    "newest_id": "1234567890123456789",
    "oldest_id": "1234567890123456788",
    "result_count": 2
  }
}

fields と expansions を追加する

クエリパラメーターで追加データをリクエストします:

cURL

curl "https://api.x.com/2/tweets/search/recent?\
query=python%20lang%3Aen%20-is%3Aretweet&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# fields と expansions を指定して検索
for page in client.posts.search_recent(
    query="python lang:en -is:retweet",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Likes: {post.public_metrics.like_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// fields と expansions を指定して検索
const paginator = client.posts.searchRecent({
  query: "python lang:en -is:retweet",
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
  maxResults: 10,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text?.slice(0, 50)}... - Likes: ${post.public_metrics?.like_count}`);
  });
}

レスポンス:

レスポンス例

{
  "data": [
    {
      "id": "1234567890123456789",
      "text": "Just started learning Python and loving it!",
      "created_at": "2024-01-15T10:30:00.000Z",
      "author_id": "9876543210",
      "public_metrics": {
        "retweet_count": 5,
        "reply_count": 2,
        "like_count": 42,
        "quote_count": 1
      },
      "edit_history_tweet_ids": ["1234567890123456789"]
    }
  ],
  "includes": {
    "users": [
      {
        "id": "9876543210",
        "username": "pythondev",
        "verified": false
      }
    ]
  },
  "meta": {
    "newest_id": "1234567890123456789",
    "oldest_id": "1234567890123456789",
    "result_count": 1
  }
}

結果をページネーションする

SDK はページネーションを自動的に処理します。cURL の場合、レスポンスの next_token を使用します:

curl "https://api.x.com/2/tweets/search/recent?\
query=python&\
max_results=100&\
next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
  -H "Authorization: Bearer $BEARER_TOKEN"

ページネーションガイド

大規模な結果セットの移動について詳しく学ぶ

クエリ例

特定ユーザーの投稿

from:XDevelopers

ハッシュタグ付きの投稿

#Python -is:retweet

画像付きの投稿

"machine learning" has:images lang:en

ユーザーをメンションする投稿

@elonmusk -is:retweet -is:reply

ドメインへのリンクを含む投稿

url:github.com lang:en

次のステップ

クエリを組み立てる

クエリ構文と演算子を習得

演算子リファレンス

利用可能なすべての演算子を確認

Full-archive search

投稿の完全アーカイブを検索

API リファレンス

エンドポイントの完全なドキュメント

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Recent Search クイックスタート

ページネーションガイド

クエリ例

次のステップ

クエリを組み立てる

演算子リファレンス

Full-archive search

API リファレンス

ページネーションガイド

​クエリ例

​次のステップ

クエリを組み立てる

演算子リファレンス

Full-archive search

API リファレンス

クエリ例

次のステップ