Recent Search 퀵스타트

이 가이드에서는 최근 7일간의 게시물을 찾기 위한 첫 recent search 요청을 만드는 방법을 안내합니다.

사전 요구사항시작하기 전에 다음이 필요합니다:

승인된 App이 있는 developer account
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")

# Search 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" });

// Search 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")

# Search with fields and 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" });

// Search with fields and 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 레퍼런스

예시 쿼리

다음 단계