| X API v2의 새로운 기능 | X API v2에 새로 추가된 엔드포인트와 기능에 대해 알아보세요. |
|---|---|
| 마이그레이션할 준비가 되셨나요? | 일련의 가이드와 지침을 통해 마이그레이션을 시작하세요. |
| 데이터 형식 마이그레이션 가이드 | 기존에 standard v1.1 및 enterprise 데이터 형식과 함께 동작하던 데이터 파서를 어떻게 다시 구성할 수 있는지 알아보세요. |
| X API 엔드포인트 맵 | standard v1.1 및 enterprise 엔드포인트가 새로운 X API v2 엔드포인트에 어떻게 매핑되는지 확인하세요. |
X API v2란?
왜 마이그레이션해야 하나요?
V2 endpoints
- Spaces 엔드포인트는 사람들이 X Spaces를 더 잘 활용할 수 있도록 돕고, 개발자가 오디오 대화의 미래를 설계하는 데 기여할 수 있도록 합니다.
- 답글 숨기기는 악의적이거나 산만하거나 오해를 불러일으킬 수 있는 답글의 영향을 대규모로 줄이는 도구를 구축할 수 있게 해 줍니다.
- 새로운 Lists 엔드포인트를 사용하면 리스트를 고정 및 고정 해제하거나, 특정 사용자의 고정된 리스트를 조회할 수 있습니다.
- 새로운 배치 규정 준수 엔드포인트를 사용하면 저장된 사용자 및 Tweet 데이터가 관련 규정을 준수하고 있는지 확인할 수 있습니다.
새로운 기능
- 엔드포인트 전반에 걸친 일관된 설계
- 응답 페이로드에 어떤 필드와 객체를 반환할지 지정할 수 있는 기능
- 새롭고 더 세분화된 데이터 객체
- Tweet 주석으로 제공되는 새로운 컨텍스트 정보를 활용해 데이터를 수신하고 필터링할 수 있는 기능
- 새로운 메트릭에 대한 접근
- 답글 스레드에 속한 대화를 쉽게 식별하고 필터링할 수 있는 기능
- 학술 연구자를 위한 고급 기능 및 데이터 접근성 확대
- 스트리밍 엔드포인트를 위한 복구 및 이중화(레던던시) 기능
- 쿼리에 일치하는 Tweet 개수를 쉽게 반환할 수 있는 기능
- Edit Tweets 지원
- 높은 신뢰도의 스팸 필터링
- 보다 효과적인 필터링 및 분석을 위해 단축 URL을 완전히 해제해 전체 URL을 제공
- 사용 중단된 필드를 제거하고 레이블을 현대화해 단순화한 JSON 응답 객체
- 검색 쿼리에서 일치하는 공개·사용 가능한 Tweet을 100% 반환
- 연결을 끊지 않고도 변경할 수 있는 스트리밍 “rules”
- Tweet 검색, Tweet 개수, 필터링된 스트림을 위한 더욱 표현력 있는 쿼리 언어
- 새로운 라이브러리를 구축하고 변경 사항을 더 투명하게 추적하기 위한 OpenAPI 스펙
새롭고 업데이트된 응답 객체 살펴보기
| Object | Description |
|---|---|
| Tweet | Tweet 객체에는 id, text, created_at와 같은 루트 수준 필드가 길게 정의되어 있습니다. Tweet 객체는 user, media, poll, place를 포함한 여러 자식 객체의 부모 객체이기도 합니다. |
| User | User 객체에는 참조된 사용자를 설명하는 X 사용자 계정 메타데이터가 포함되어 있습니다. |
| Spaces | Space 객체에는 state, host_id, is_ticketed, lang 등의 필드가 포함됩니다. |
| Lists | 리스트 객체에는 요청된 리스트에 대한 기본 정보(description, member_count, owner_id 등)가 포함됩니다. |
| Media | Tweet에 이미지와 같은 미디어가 포함되어 있는 경우, media.fields 매개변수를 사용해 media 객체를 요청할 수 있으며, media_key, type, url, preview_image_url 등의 필드가 포함됩니다. |
| Poll | Tweet에 포함된 투표는 어떤 엔드포인트에서도 기본(주) 객체는 아니지만, Tweet 객체에서 조회하고 확장할 수 있습니다. |
| Place | place 객체에는 place_id, geo 객체, country_code 등의 필드가 포함됩니다. 이 정보는 Tweet을 식별하고 위치 기준으로 Tweet을 분석하는 데 사용할 수 있습니다. |
수신할 객체와 필드를 유연하게 선택하기
id 및 text 필드를 제공합니다.
요청에 추가 필드를 포함해 가져오려면 fields 및 expansions 파라미터를 사용해야 합니다. expansions 파라미터를 사용하면 사용자의 고정 Tweet이나 미디어 객체와 같은 관련 데이터 객체를 가져올 수 있고, 필드 관련 파라미터를 사용하면 기본값을 넘어 반환된 객체 내에서 특정 필드를 선택적으로 요청할 수 있습니다.
다음은 다양한 X API v2 엔드포인트에서 요청할 수 있는 expansions의 전체 목록입니다:
| Object / Resource | Available Expansions |
|---|---|
| Tweets | author_id, edit_history_tweet_ids, entities.mentions.username, in_reply_to_user_id, referenced_tweets.id, referenced_tweets.id.author_id, attachments.poll_ids, attachments.media_keys, geo.place_id |
| Users | pinned_tweet_id |
| Spaces | invited_user_ids, speaker_ids, creator_id, host_ids, topic_ids |
Tweet, 사용자, Spaces, 리스트, 미디어 객체에서 사용 가능한 신규 지표
| 객체 | 사용 가능한 지표 | 공개 지표 | 비공개 지표 | 오가닉 지표 | 프로모션 지표 |
|---|---|---|---|---|---|
| tweets | retweet_count | ✔️ | ✔️ | ✔️ | |
| quote_count | ✔️ | ||||
| like_count | ✔️ | ✔️ | ✔️ | ||
| reply_count | ✔️ | ✔️ | ✔️ | ||
| impression_count | ✔️ | ✔️ | ✔️ | ||
| url_profile_clicks | ✔️ | ✔️ | ✔️ | ||
| url_link_clicks | ✔️ | ✔️ | ✔️ | ||
| user | follower_count | ✔️ | |||
| user | following_count | ✔️ | |||
| media | view_count | ✔️ | |||
| media | playback_0_count | ✔️ | |||
| space | participant_count | ✔️ |
Tweet 편집
- Tweet이 생성 시점에 편집 자격이 있었는지 여부. 설문조사가 포함된 Tweet이나 예약된 Tweet 등 일부 Tweet은 편집할 수 없습니다.
- Tweet은 30분 동안 편집할 수 있으며, 최대 5번까지 편집이 가능합니다. 편집 가능한 Tweet의 경우 남은 편집 가능 시간과 추가로 몇 번 더 편집할 수 있는지 확인할 수 있습니다.
- 현재 보고 있는 Tweet이 편집된 버전인지 여부(대부분의 경우, 특정 과거 버전을 Tweet ID로 요청하지 않는 한 API는 해당 Tweet의 최신 버전을 반환합니다).
- 해당 Tweet의 전체 편집 기록.
- Tweet 각 버전에 귀속되는 참여(engagement) 지표.
스레드 대화 추적
마이그레이션 준비
인증
도구 및 코드
- Twitter Postman 컬렉션을 사용하면 Postman 클라이언트로 개별 엔드포인트에 요청을 보내고 연결할 수 있습니다. 이는 인증을 테스트하고 엔드포인트를 시험해 보기에 간편한 방법입니다.
- 또한 Ruby, Python, Node.js, Java 등 다양한 언어에 대해 Twitter에서 지원하는 라이브러리와 서드파티 라이브러리 목록을 제공하고 있습니다. 자세한 내용은 도구 및 라이브러리 페이지를 참조하세요.
업데이트된 엔드포인트로 마이그레이션하기
- Tweets
- Users
- 리스트
새로운 데이터 형식으로 마이그레이션
- 네이티브 형식에서 X API v2(standard v1.1)로
- Native Enriched에서 X API v2(enterprise)로
- Activity Streams에서 X API v2(enterprise)로