Skip to main content
이 가이드는 Search Posts 엔드포인트를 애플리케이션에 통합할 때 알아야 할 핵심 개념을 다룹니다.

인증

Recent search는 여러 인증 방식을 지원합니다: Full-archive search는 OAuth 2.0 App-Only 인증만 지원합니다.
비공개 지표(non_public_metrics, organic_metrics, promoted_metrics)는 App-Only 인증만 지원하는 full-archive search에서는 사용할 수 없습니다.

쿼리 작성

쿼리는 연산자를 사용해 게시물을 매칭합니다. boolean 로직으로 연산자를 조합하세요:

쿼리 길이 제한

연산자 유형

쿼리 작성

쿼리 구문을 자세히 익히기

연산자 레퍼런스

사용 가능한 모든 연산자 보기

Fields 및 expansions

기본적으로 응답에는 id, text, edit_history_tweet_ids만 포함됩니다. 추가 데이터를 요청하려면 파라미터를 사용하세요.

예시 요청

cURL

사용 가능한 expansions

Fields 및 expansions 가이드

응답 커스터마이징에 대해 자세히 알아보기

페이지네이션

Search 엔드포인트는 페이지 단위로 결과를 반환합니다. 응답의 next_token을 사용해 추가 페이지를 가져오세요.

동작 방식

  1. max_results와 함께 첫 요청을 만듭니다
  2. meta 객체에서 next_token을 확인합니다
  3. 후속 요청에 next_token을 포함시킵니다
  4. next_token이 반환되지 않을 때까지 반복합니다

예시

cURL

페이지네이션 가이드

페이지네이션에 대해 자세히 알아보기

게시물 편집

게시물은 30분 이내에 최대 5회까지 편집할 수 있습니다. Search 엔드포인트는 항상 가장 최근 버전을 반환합니다.

고려 사항

  • edit_history_tweet_ids에는 모든 Post ID가 포함됩니다(가장 오래된 것부터)
  • 30분 창이 지난 후 가져온 게시물은 최종 버전을 나타냅니다
  • 거의 실시간 사용 사례에서는 최근에 게시된 게시물이 여전히 편집될 수 있습니다

게시물 편집 기본

게시물 편집에 대해 자세히 알아보기

모범 사례

구체적으로 시작

여러 연산자를 사용해 결과를 좁히고 노이즈를 줄이세요.

반복적으로 테스트

광범위하게 시작한 뒤 결과를 기반으로 다듬으세요.

페이지네이션 처리

큰 결과 집합에 대해 적절한 페이지네이션을 구현하세요.

결과 캐싱

반복 요청을 피하기 위해 결과를 로컬에 저장하세요.

다음 단계

쿼리 작성

쿼리 구문 마스터하기

연산자 레퍼런스

사용 가능한 모든 연산자

페이지네이션

큰 결과 집합 처리

API 레퍼런스

전체 엔드포인트 문서