> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 개요
> v2 Search Tweets 엔드포인트는 향후 standard v1.1 search/posts 엔드포인트를 대체할 예정입니다. migrate를 다루는 X API v2 standard 티어 레퍼런스입니다.
## X API의 Search Posts 엔드포인트 비교
v2 Search Tweets 엔드포인트는 향후 [standard v1.1 search/posts](/x-api/posts/search/introduction) 엔드포인트와 [enterprise Search API](/x-api/enterprise-gnip-2.0/fundamentals/search-api)를 대체할 예정입니다. 이전 버전의 X search 엔드포인트를 사용하는 코드, 앱 또는 도구를 새로운 X API v2 엔드포인트로 마이그레이션하는 것을 고려 중이라면 이 가이드가 유용할 것입니다.
***
## Recent search 비교
다음 표는 다양한 유형의 recent search 엔드포인트를 비교합니다:
| **Description** | **Standard v1.1** | **X API v2** |
| :-------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Host domain | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint path | /1.1/search/tweets.json | /2/tweets/search/recent |
| [인증](/resources/fundamentals/authentication) | OAuth 1.0a User Context
OAuth 2.0 App-Only | OAuth 1.0a User Context
OAuth 2.0 Authorization Code with PKCE
OAuth 2.0 App-Only |
| Timestamp format | YYYYMMDD | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| 반환되는 게시물의 최대 과거 기간 | 7일 | 7일 |
| 지원 HTTP 메서드 | GET | GET |
| 기본 요청 rate limit | OAuth 1.0a User Context 시 15분당 180 요청
OAuth 2.0 App-Only 시 15분당 450 요청 | **Self-serve:**
OAuth 2.0 App-Only 시 15분당 60 요청
OAuth 1.0a User Context 시 15분당 60 요청
OAuth 2.0 Authorization Code with PKCE 시 15분당 60 요청 |
| 완전 unwound URL 제공 | | ✔ |
| 응답당 최대 게시물 수(기본값) | 100 (15) | 100 (10) |
| Post JSON 형식 | Standard v1.1 format | [X API v2 format](/x-api/fundamentals/data-dictionary) (fields 및 expansions 요청 파라미터로 결정되며, v1.1 형식과 하위 호환되지 않음)
Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법은 [데이터 형식 마이그레이션 가이드](/x-api/migrate/data-format-migration)를 참고하세요. |
| 페이로드에 반환되는 [필드](/x-api/fundamentals/fields) 선택 지원 | | ✔ |
| [annotations](/x-api/fundamentals/post-annotations) 요청 및 수신 지원 | | ✔ |
| Post 객체 내 특정 [metrics](/x-api/fundamentals/metrics) 요청 지원 | | ✔ |
| [conversation\_id](/x-api/fundamentals/conversation-id) 연산자 및 필드 지원 | | ✔ |
| Post 편집 히스토리 제공 | ✔ | ✔ |
| Post 데이터 배열의 JSON 키 이름 | statuses | data |
| 페이지네이션용 JSON 키 이름 | search\_metadata.next\_results | meta.next\_token |
| 시간 범위로 아카이브 탐색 지원 | ✔ | ✔ |
| 시간 기반 요청의 시간 해상도 | day | second |
| 시간대 | UTC | UTC |
| 시간으로 탐색하기 위한 요청 파라미터 | until | start\_time
end\_time |
| Post ID로 탐색하기 위한 요청 파라미터 | since\_id
max\_id | since\_id
until\_id |
| 페이지네이션용 요청 파라미터 | URL 인코딩된 쿼리 제공 | next\_token |
| [Project](/resources/fundamentals/developer-apps)에 연결된 [developer App](/resources/fundamentals/developer-apps)의 자격 증명 사용 필요 | | ✔ |
### Full-archive search 비교
다음 표는 다양한 유형의 full-archive search 엔드포인트를 비교합니다:
| **Description** | **Enterprise** | **X API v2** |
| :------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
| Host domain | [https://gnip-api.x.com](https://gnip-api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint path | /search/fullarchive/accounts/:account\_name/:label | /2/tweets/search/all |
| [인증](/resources/fundamentals/authentication) | Basic auth | OAuth 2.0 App-Only |
| Timestamp format | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| 반환되는 게시물의 최대 과거 기간 | 2006년 3월 이후 전체 아카이브 | 2006년 3월 이후 전체 아카이브 |
| 지원 HTTP 메서드 | GET
POST | GET |
| 기본 요청 rate limit | 분당 rate limit은 계약에 명시된 대로 파트너에 따라 다릅니다.
Basic auth 시 초당 20 요청 | OAuth 2.0 App-Only 시 15분당 300 요청
OAuth 2.0 App-Only 시 초당 1 요청 |
| 완전 unwound URL 제공 | ✔ | ✔ |
| 응답당 게시물 수 | 최대: 500
기본값: 100 | 최대: 500
기본값: 10 |
| Post JSON 형식 | [Native Enriched 또는 Activity Streams](/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary) format | [X API v2](/x-api/fundamentals/data-dictionary) format (fields 및 expansions 요청 파라미터로 결정) |
| 페이로드에 반환되는 [필드](/x-api/fundamentals/fields) 선택 지원 | | ✔ |
| [annotations](/x-api/fundamentals/post-annotations) 요청 및 수신 지원 | | ✔ |
| Post 객체 내 특정 [metrics](/x-api/fundamentals/metrics) 요청 지원 | | ✔ |
| [conversation\_id](/x-api/fundamentals/conversation-id) 연산자 및 필드 지원 | | ✔ |
| Post 편집 히스토리 제공 | ✔ | ✔ |
| Post 데이터 배열의 JSON 키 이름 | results | data |
| 페이지네이션용 JSON 키 이름 | **next** | meta.next\_token |
| 시간 기반 요청의 시간 해상도 | second | second |
| 시간대 | UTC | UTC |
| Post ID로 아카이브 탐색 지원 | | ✔ |
| 시간으로 탐색하기 위한 요청 파라미터 | fromDate
toDate | start\_time
end\_time |
| Post ID로 탐색하기 위한 요청 파라미터 | | since\_id
until\_id |
| 페이지네이션용 요청 파라미터 | next\_token | next\_token |
| Academic Research access가 있는 [Project](/resources/fundamentals/developer-apps)에 연결된 [developer App](/resources/fundamentals/developer-apps)의 자격 증명 사용 필요 | | ✔ |
**필터링 연산자 비교**
search Posts의 네 가지 다른 버전(standard, enterprise, v2)은 사용 가능한 연산자가 서로 다르며, 각 버전 내에서도 연산자 가용성 수준이 다릅니다. 아래에서 설명합니다.
Enterprise
* enterprise 연산자에는 하위 티어가 없습니다
X API v2
* **Self-serve:** 모든 Project 사용 시 이용 가능
* **Enterprise:** Project 사용 시 이용 가능
각 연산자 세트에 대한 자세한 내용은 다음 가이드를 참고하세요:
* [Enterprise operators](/x-api/enterprise-gnip-2.0/fundamentals/search-api#available-operators)
* [X API v2 operators](/x-api/posts/search/integrate/build-a-query#operators)
X API v2 내 서로 다른 연산자 수준을 이해했으니, 이제 search Posts에 대한 연산자 가용성을 정리한 표를 살펴봅시다(셀이 비어 있으면 해당 연산자는 사용할 수 없음):
| Search operator | Standard | Enterprise | v2 |
| :---------------------------------- | :---------------------------------------- | :--------- | :---------------------------------- |
| keyword | Available
q:keyword | Available | Available |
| emoji | Available
q:😄 | Available | Available |
| "exact phrase" | Available | Available | Available |
| # | Available | Available | Available |
| \$ | Available | Available | Available |
| @ | Available | Available | Available |
| from: | Available | Available | Available |
| to: | Available | Available | Available |
| url: | Available | Available | Available |
| retweets\_of: | | Available | Available |
| context: | | | Available |
| entity: | | | Self-serve - recent search에서만 사용 가능 |
| conversation\_id: | | | Available |
| place: | | Available | Available |
| place\_country: | | Available | Available |
| point\_radius: | geocode parameter | Available | Available |
| bounding\_box: | | Available | Available |
| is:retweet | filter:retweets | Available | Available |
| is:reply | | Available | Available |
| is:quote | | Available | Available |
| is:verified | | Available | Available |
| -is:nullcast | | Available | Available |
| has:hashtags | | Available | Available |
| has:cashtags | | Available | Available |
| has:links | filter:links | Available | Available |
| has:mentions | | Available | Available |
| has:media | filter:media | Available | Available |
| has:images | filter:images, filter:twimg | Available | Available |
| has:videos | filter:videos
filter:native\_video | Available | Available |
| has:geo | | Available | Available |
| lang: | lang - 연산자 또는 파라미터로 사용 가능 | Available | Available |
| has:profile\_geo | | Available | |
| profile\_country | | Available | |
| profile\_locality | | Available | |
| profile\_region | | Available | |
| proximity | | Available | |
| :( | Available | | |
| :) | Available | | |
| ? | Available | | |
| filter:periscope | Available | | |
| list: | Available | | Available |
| filter:replies | Available | | |
| filter:pro\_video | Available | | |
| filter:social | Available | | |
| filter:trusted | Available | | |
| filter:follows | Available | | |
| filter:has\_engagement | Available | | |
| include:antisocial | Available | | |
| include:offensive\_user | Available | | |
| include:antisocial\_offensive\_user | Available | | |
| include:sensitive\_content | Available | | |
| source: | Available | | |
| min\_replies: | Available | | |
| min\_retweets: | Available | | |
| min\_faves: | Available | | |
| card\_name: | Available | | |
| card\_domain: | Available | | |
**기타 마이그레이션 리소스**
[X API 마이그레이션 허브](/x-api/migrate/overview)
[이 엔드포인트의 샘플 코드 살펴보기](https://github.com/xdevplatform/Twitter-API-v2-sample-code "이 엔드포인트의 샘플 코드 살펴보기")
[Search Posts: Standard v1.1 to X API v2](/x-api/posts/search/migrate/standard-to-twitter-api-v2)
[Search Posts: Enterprise to X API v2](/x-api/posts/search/migrate/enterprise-to-twitter-api-v2)