X API v2는 이제 주요 X API이며, 제품 투자와 혁신이 집중되는 영역입니다. 우리는 다양한 개발자 커뮤니티를 더 잘 지원하기 위해 개발자들과 협력하여 차세대 X API를 구축해 왔습니다. 개발자 피드백을 바탕으로 더 폭넓은 요구 사항을 충족하고, 새로운 기능과 엔드포인트를 도입하며, 개발자 경험을 개선할 수 있도록 API를 다시 설계했습니다. X API v2는 이제 주요 X API이며, 제품 투자와 혁신이 집중되는 영역입니다. 지난 몇 년 동안 우리는 개발자들과 협력하여 더 폭넓은 요구 사항을 충족하고, 새로운 기능과 엔드포인트를 도입하며, 개발자 경험을 개선할 수 있도록 API를 다시 설계해 왔습니다. 우리는 개방형 개발자 플랫폼을 지속적으로 구축하는 데 전념하고 있으며, 여러분이 X API v2를 활용해 무엇을 만들지 기대하고 있습니다. X API v2는 현대적이고 더 지속 가능한 기반 위에 구축되었으며, 표준 v1.1 및 엔터프라이즈 제품을 위한 향상된 대체 엔드포인트뿐만 아니라 완전히 새로운 기능도 제공합니다. 당사는 레거시 API(v1.1 및 엔터프라이즈) 사용자가 v2로의 마이그레이션을 시작할 것을 강력히 권장하며, 해당 API들은 장기적으로 사용이 중단될 예정입니다. X API를 사용하여 공개 대화를 모니터링하고 분석하며, X에서 사람들과 소통하고, 새로운 기능을 혁신적으로 활용해 보세요. 이 섹션에서는 엔드포인트와 기능에 대해 설명합니다. 다음 가이드를 통해 v2 엔드포인트 전체 목록과 v2 이전 버전에서의 대응 엔드포인트를 확인할 수 있습니다: 대부분의 X API v2 엔드포인트는 기존 엔드포인트를 대체하지만, 여러 새로운 엔드포인트도 도입했습니다. 다음은 v2에서 새로 제공하는 엔드포인트의 몇 가지 예시입니다:
- Spaces 엔드포인트는 사람들이 X Spaces를 더 잘 활용할 수 있도록 돕고, 개발자가 오디오 대화의 미래를 설계하는 데 기여할 수 있도록 합니다.
- 답글 숨기기는 악의적이거나 산만하거나 오해를 불러일으킬 수 있는 답글의 영향을 대규모로 줄이는 도구를 구축할 수 있게 해 줍니다.
- 새로운 Lists 엔드포인트를 사용하면 리스트를 고정 및 고정 해제하거나, 특정 사용자의 고정된 리스트를 조회할 수 있습니다.
- 새로운 배치 규정 준수 엔드포인트를 사용하면 저장된 사용자 및 Tweet 데이터가 관련 규정을 준수하고 있는지 확인할 수 있습니다.
- 엔드포인트 전반에 걸친 일관된 설계
- 응답 페이로드에 어떤 필드와 객체를 반환할지 지정할 수 있는 기능
- 새롭고 더 세분화된 데이터 객체
- Tweet 주석으로 제공되는 새로운 컨텍스트 정보를 활용해 데이터를 수신하고 필터링할 수 있는 기능
- 새로운 메트릭에 대한 접근
- 답글 스레드에 속한 대화를 쉽게 식별하고 필터링할 수 있는 기능
- 학술 연구자를 위한 고급 기능 및 데이터 접근성 확대
- 스트리밍 엔드포인트를 위한 복구 및 이중화(레던던시) 기능
- 쿼리에 일치하는 Tweet 개수를 쉽게 반환할 수 있는 기능
- Edit Tweets 지원
- 높은 신뢰도의 스팸 필터링
- 보다 효과적인 필터링 및 분석을 위해 단축 URL을 완전히 해제해 전체 URL을 제공
- 사용 중단된 필드를 제거하고 레이블을 현대화해 단순화한 JSON 응답 객체
- 검색 쿼리에서 일치하는 공개·사용 가능한 Tweet을 100% 반환
- 연결을 끊지 않고도 변경할 수 있는 스트리밍 “rules”
- Tweet 검색, Tweet 개수, 필터링된 스트림을 위한 더욱 표현력 있는 쿼리 언어
- 새로운 라이브러리를 구축하고 변경 사항을 더 투명하게 추적하기 위한 OpenAPI 스펙
필드와 expansions를 사용하는 방법에 대해 더 알아보세요.
GET 엔드포인트에 요청을 보내면 해당 엔드포인트와 관련된 기본 데이터 객체를 받게 되며, 여기에는 기본 필드 집합이 포함됩니다. 예를 들어, Tweet 객체는 기본적으로
id 및 text 필드를 제공합니다.
요청에 추가 필드를 포함해 가져오려면 fields 및 expansions 파라미터를 사용해야 합니다. expansions 파라미터를 사용하면 사용자의 고정 Tweet이나 미디어 객체와 같은 관련 데이터 객체를 가져올 수 있고, 필드 관련 파라미터를 사용하면 기본값을 넘어 반환된 객체 내에서 특정 필드를 선택적으로 요청할 수 있습니다.
다음은 다양한 X API v2 엔드포인트에서 요청할 수 있는 expansions의 전체 목록입니다:
fields와 expansions를 사용하는 방법에 대해 더 자세히 알아보세요.
이제 Tweet, 사용자, Spaces, 리스트, 미디어 객체에서 더 많은 지표를 조회할 수 있습니다. 이 지표에는 공개 지표와 비공개 지표가 모두 포함되며, 일부 지표는 Tweet 광고에서 오가닉(organic) 또는 프로모션(promoted) 컨텍스트로 세분해 확인할 수 있습니다.
사용 가능한 지표에 대해 더 알아보세요.
X API v2 엔드포인트는 편집된 Tweet 메타데이터를 제공합니다. Edit Tweet 기능은 2022년 9월 1일 X 직원들을 대상으로 테스트 목적으로 처음 도입되었습니다. 그날부터 편집 자격이 있는 Tweet은 30분 동안 최대 5번까지 편집할 수 있습니다. Tweet 편집에 대해 더 알아보세요.
X API v2를 사용하면 개발자는 다음을 확인할 수 있습니다:
- 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)로