Account Activity API 엔드포인트 출시
오늘 새로운 X API v2 Account Activity API 엔드포인트를 출시했습니다. 자세한 내용은 여기를 참고하세요.Media Upload 엔드포인트 개선
개발자 경험을 향상하기 위해 Media Upload 엔드포인트를 일부 개선했습니다. 청크 단위 Media Upload용 전용 엔드포인트인 Media Upload 엔드포인트를 도입했습니다. 자세한 내용은 여기를 참고하세요.Media Upload 엔드포인트 출시
오늘 새로운 X API v2 Media Upload 엔드포인트를 출시했습니다. 자세한 내용은 여기를 참고하세요.새로운 문서 사이트 출시
오늘 새로운 X Developer Platform 문서 사이트 https://docs.x.com을 출시했습니다.Historical Powertrack 엔드포인트 사용 중단
오늘 엔터프라이즈 X API에서 Historical Powertrack 및 Insights track 엔드포인트의 사용을 중단합니다.Basic 및 Pro 티어에서 Follows 엔드포인트 제거
오늘 X API v2의 Basic 및 Pro 티어에서 Follows 및 List Follows 엔드포인트를 제거합니다.북마크 수 및 긴 게시물 지원
오늘 X API v2에서 북마크 수를 조회하고 280자를 초과하는 게시물을 조회할 수 있는 기능을 추가했습니다.Statuses/Filter 엔드포인트 사용 중단
오늘 X API v1.1의 statuses/filter 엔드포인트 사용을 중단합니다. 개발자는 X API v2의 filtered stream 엔드포인트를 사용할 수 있습니다.조회 수 지원
오늘 X API v2에 조회 수 지원을 추가합니다. 게시물 페이로드의 public_metrics에impression_count라는 새 필드가 제공됩니다.Verified Type 필드 추가
오늘 사용자 계정이 보유한 인증 유형(파란색, 비즈니스, 정부 또는 없음)을 나타내는verified_type 사용자 필드를 X API v2에 추가합니다.필터링 연산자 별칭 추가
검색 및 filtered stream 엔드포인트 전반에 걸쳐, 엔터프라이즈, 프리미엄, v2에 필터링/쿼리 연산자 “별칭”이 추가되었습니다. 많은 경우 연산자는 statuses 대신 게시물을 참조합니다. 예를 들어"in_reply_to_tweet_id"는 "in_reply_to_status_id"의 별칭입니다. 다른 경우에는 새로운 연산자 별칭이 수행되는 매칭을 더 명확하게 보여 줍니다. 예를 들어 게시물은 하나의 비디오 첨부만 가질 수 있으므로 "has:videos"에 대해 새로운 "has:video_link" 별칭이 제공됩니다. 더 많은 예시는 v2 filtered stream 연산자 표를 확인하세요.역순(최신순) 홈 타임라인 업데이트
오늘부터 역순(최신순) 홈 타임라인 v2 엔드포인트는 최근 7일 동안 타임라인에서 생성된 모든 포스트와, 생성 날짜와 관계없이 가장 최근의 800개를 반환할 수 있습니다.역순(최신순) 홈 타임라인 엔드포인트 출시
오늘 새로운 엔드포인트를 출시하여, 여러분이 팔로우하는 계정이 가장 최근에 게시하거나 리포스트한 게시물 모음을 가져올 수 있습니다.이번 출시와 관련해 자세히 알아보려면 포럼 공지를 방문하세요.새 엔드포인트와 함께, 이제 media object에variants 필드를 사용할 수 있습니다. 이를 통해 해당 URL에 연결된 콘텐츠의 type을 확인할 수 있습니다.인용 게시물 조회 엔드포인트 출시
오늘부터 게시물 ID를 기준으로 인용 게시물을 가져올 수 있는 인용 게시물 조회 엔드포인트를 출시합니다.이 출시와 관련해 더 알아보려면 포럼 공지를 방문하세요.OAuth 2.0 인증 지원
오늘부터 모든 개발자는 개발자 콘솔에서 인증 방법으로 OAuth 2.0을 선택해 인증할 수 있습니다. 이번 릴리스에서는 confidential Client 및 public Client 모두에 대한 지원과, 이 인증 방법을 사용할 수 있는 모든 관련 v2 엔드포인트를 추가했습니다.OAuth 2.0은 업계 표준 인가 프로토콜로, 개발자가 애플리케이션의 스코프를 더 세밀하게 제어할 수 있게 해 주고 여러 기기에서의 인가 플로우를 개선합니다. 다시 말해, X 사용자용 애플리케이션을 구축하는 개발자는 자신의 App이 사용자에게 요청하는 정보에 대해 더 많은 제어권을 갖게 되며, 최종 사용자에게는 필요한 데이터와 정보만 요청하면 됩니다.이 최신 인가 프로토콜을 사용하면, App 인가를 위해 최종 사용자에게 제시하는 동의 플로우를 더 간소화할 수 있으며, 그들에게 요청한 구체적인 스코프만 표시할 수 있습니다.이번 출시 내용에 대해 더 알아보려면 포럼 공지를 방문하세요.X API v2를 위한 주요 플랫폼 업데이트
주요 플랫폼 업데이트: X API v2가 이제 기본 버전이 되었으며, 새로운 Essential 및 Elevated 액세스, 그리고 정책 변경이 포함됩니다.오늘 저희는 X API v2가 이제 X API의 기본 버전이 되었음을 발표합니다. 우리는 X API v2에 충분한 엔드포인트와 기능을 제공하여, X API 위에 구축된 기존 App의 90%에 해당하는 요구 사항을 충족할 수 있게 했습니다.또한 X API v2 개발자 경험을 더욱 향상시키기 위해 오늘 다음과 같은 변경 사항을 출시합니다.- API에 대한 빠르고 무료인 Essential 액세스, 그리고 사용 사례 승인을 받은 개발자에게 제공되는 무료 Elevated 액세스. 이러한 액세스 수준에 대한 더 자세한 내용은 ‘About the X API’ 페이지에서 확인할 수 있습니다.
-
X의 핵심 기능을 사용하는 방식과, App을 통해 지원할 수 있는 사용자 수를 제한하던 개발자 정책상의 문구를 제거하고 있습니다.
- 플랫폼을 개방하여, 여러분이 X를 더 나은 곳, 더 건강한 곳으로 만들고 공적 대화를 확장하는 도구와 제품을 구축할 수 있도록 장려하려 합니다. 우리가 여러분이 구축해 주기를 기대하는 솔루션 목록을 확인하세요.
- 구체적으로, X의 핵심 기능을 포함한 X 경험의 복제를 제한하던 조항과, 많은 수의 사용자 토큰을 보유하려면 승인이 필요하도록 했던 조항을 제거했습니다.
- X에서 사람들을 돕는 솔루션을 구축한다는 것은, 개발자가 종종 X에서 제공되는 일부 기능을 직접 구축(또는 복제)해야 함을 의미한다는 것을 알고 있습니다. 이번 개발자 정책 변경은 개발자 생태계에 명확성을 제공하고, 개발자가 공적 대화에 기여하는 서비스를 더 쉽게 구축하고 혁신할 수 있도록 하는 개방형 API 플랫폼을 제공하기 위한 것입니다.
List 조회 엔드포인트 출시
오늘 우리는 새로운 List 조회 엔드포인트를 X API v2에 출시합니다. 이 엔드포인트를 사용하면 팔로워, 멤버, 포스트 등 특정 리스트에 대한 세부 정보를 조회할 수 있습니다. 조회된 데이터는 큐레이션, 분석, 검색 가능성 등의 사용 사례와 요구 사항을 해결하는 솔루션을 구축하는 데 활용할 수 있습니다. 새로운 List 엔드포인트와 더불어, Academic Research 액세스 레벨에서 사용할 수 있는 새로운list: 연산자도 제공됩니다. 이는 포스트 검색과 포스트 개수 조회에 사용할 수 있습니다.이번 출시 내용에 대해 더 알아보려면 포럼 공지를 방문하세요.뮤트 조회 엔드포인트 출시
오늘 X API v2에 새로운 mutes lookup 엔드포인트를 출시합니다. 이 엔드포인트를 사용하면 인증된 사용자가 자신이 뮤트한 계정을 조회하고 관련 정보를 가져올 수 있습니다.이번 출시와 관련해 더 알아보려면 포럼 공지를 방문하세요.OAuth 2.0 베타 출시
오늘 X API v2에서 OAuth 2.0 및 세분화된 스코프의 베타를 출시합니다. X Developer Platform에서 OAuth 2.0의 미래를 함께 만들어 가고 싶은 개발자는 OAuth 2.0 베타 접근 권한을 요청할 수 있습니다.OAuth 2.0은 인증을 위한 업계 표준이며, 더욱 현대적인 인가 경험을 제공합니다.OAuth 2.0 베타를 통해 v2 Project 및 연결된 App에서 이 새로운 기능을 테스트하고, 정식 출시(General Availability) 전에 피드백을 제공할 수 있습니다. 다만, 이 OAuth 2.0 구현은 현재 개발 중이므로, 공개 프로덕션 환경이나 앱에서 테스트하는 것은 삼가실 것을 강력히 권장합니다.이번 출시와 관련해 더 알아보려면 포럼 공지를 방문하세요.배치 컴플라이언스 엔드포인트 출시
오늘 X API를 사용하는 개발자가 X 데이터를 당사의 Developer Agreement and Policy를 준수하도록 더 쉽게 유지할 수 있도록, X API v2에 새로운 batch compliance endpoints를 출시합니다. 이 엔드포인트를 사용하면 개발자와 연구자가 대량의 포스트 또는 User ID를 배치 업로드하고, 데이터셋이 사용자 의도와 X에서의 현재 콘텐츠 상태를 반영하도록 하기 위해 어떤 조치가 필요한지 파악할 수 있습니다.이번 출시와 관련해 더 알아보려면 포럼 공지를 방문하세요.Spaces 엔드포인트 출시
오늘 우리는 새로운 Spaces 엔드포인트와 새로운 최상위 Spaces 데이터 사전을 X API v2에 출시합니다. Spaces 엔드포인트를 사용하면 Space ID 또는 user ID로 Spaces를 조회하거나, Space 제목에 언급된 사람의 키워드, 해시태그 또는 사용자 이름을 사용해 조회할 수 있습니다. 새로운 데이터 사전에는 Space의 제목, 티켓팅 상태, 참여자 지표와 같은 관련 정보가 포함되어 있으며, 모든 user ID는 전체 객체로 확장될 수 있습니다.이번 출시와 관련해 더 자세히 알아보려면 포럼 공지를 방문하세요.동영상 조회수 제한을 위한 새 객체
이전에 enterprise [Engagement API]/x-api/enterprise-gnip-2.0/fundamentals/engagement-api)를 사용해 게시 후 1,800일이 지난 포스트에 대해 동영상 조회수 메트릭을 요청하면, 별다른 설명 없이 0 값만을 제공했습니다. 오늘부터는 이러한 경우에 unsupported_for_video_views_tweet_ids라는 새로운 객체를 제공하며, 여기에 1,800일이 지난 포스트 ID의 쉼표로 구분된 리스트가 포함됩니다. 이 포스트들에 대해 요청한 다른 메트릭은 모두 별도의 객체로 계속 제공됩니다.이번 출시와 관련해 더 자세히 알아보려면 포럼 공지를 방문하세요.Manage Mutes 엔드포인트 출시
오늘 우리는 새로운 manage mutes 엔드포인트를 X API v2에 출시합니다. 이 엔드포인트를 사용하면 인증된 사용자가 계정을 뮤트하거나 뮤트 해제할 수 있습니다.이번 출시와 관련해 더 자세히 알아보려면 포럼 공지를 방문하세요.이제tweet.fields 파라미터와 함께 context_annotations 필드를 요청하는 경우, full-archive search 엔드포인트에서 제공되는 max_results를 100으로 줄였습니다. 이는 페이지당 해당 필드와 함께 최대 100개의 포스트만 조회할 수 있음을 의미합니다.스트리밍 엔드포인트를 위한 안정성 기능
오늘 X API v2의 필터 스트림과 샘플 스트림에 대해, 백필(backfill)과 중복 연결(redundant connections)이라는 두 가지 스트리밍 안정성 기능을 Academic Research 제품 트랙에서 사용할 수 있도록 출시했습니다.중복 연결 기능을 사용하면 하나의 스트림에 두 번 연결할 수 있어, 스트림 중 하나에 연결 해제가 발생하더라도 스트리밍 가동 시간을 최대화하는 데 도움이 됩니다.백필은 스트리밍 요청에backfill_minutes 파라미터와 1에서 5 사이의 정수를 추가하여 사용할 수 있으며, 연결이 끊어진 스트림으로 인해 놓쳤을 수 있는 데이터를 다시 요청할 수 있게 해 줍니다.이 출시 내용에 대해 더 알아보려면 포럼 공지를 방문하세요.포스트 개수 엔드포인트 출시
오늘 X API v2에 새로운 포스트 개수 엔드포인트를 출시했습니다. 여기에는 두 가지 서로 다른 엔드포인트가 포함됩니다. 모든 제품 트랙에서 사용할 수 있는 최근 포스트 개수와, 현재는 Academic Research 제품 트랙에서만 사용할 수 있는 전체 아카이브 포스트 개수입니다. 이 엔드포인트를 사용하면 지정한 쿼리와 일치하는 포스트 개수를 받을 수 있습니다.이 출시 내용에 대해 더 알아보려면 포럼 공지를 방문하세요.팀 기능 개선
오늘 커뮤니티에서 받은 피드백을 바탕으로 팀 기능에 대한 핵심 개선 사항을 출시합니다. 팀 페이지의 스타일과 디자인을 업데이트했습니다. 또한 초대 흐름을 변경하여 팀 구성원을 더 쉽게 초대하고, 초대가 실패했을 수 있는 이유를 더 잘 이해할 수 있도록 했습니다. 팀 계정을 보유하고 있다면 개발자 콘솔의 팀 페이지를 확인하여 변경 사항을 살펴볼 수 있습니다. 팀에 대해 더 알아보려면 해당 주제에 대한 [문서](https://developer.x.com/en/docs/Developer Console/overview#team)와 관련 [FAQ](https://developer.x.com/en/docs/Developer Console/faq#dev-portal-management-faq)를 참고하세요.이 출시 내용에 대해 더 알아보려면 포럼 공지를 방문하세요.차단 및 좋아요 조회 엔드포인트 출시
오늘 X API v2에 새로운 차단(blocks) 및 좋아요(Likes) 조회 엔드포인트를 출시했습니다. 이 엔드포인트를 사용하면 v2 API를 통해, 어떤 계정이 어떤 포스트에 좋아요를 눌렀는지, 어떤 사용자가 특정 포스트에 좋아요를 눌렀는지, 그리고 여러분 또는 인증된 사용자가 누구를 차단했는지에 대한 정보를 가져올 수 있습니다.이 출시 내용에 대해 더 알아보려면 포럼 공지를 방문하세요.임베드된 타임라인 지원 중단
오늘 우리는 임베드된 타임라인 위젯의 향후 계획을 공유합니다. 2021년 6월 23일에 좋아요, 컬렉션, 모멘트 타임라인을 더 이상 제공하지 않을 예정입니다. 대신, 더 빠르고 사용하기 쉬우며 최신 X 기능과 동작 방식에 더 잘 맞도록 업데이트 중인 프로필 타임라인과 리스트 타임라인 사용을 권장합니다.이 변경 사항에 대해 더 알아보려면 포럼 공지를 참고하세요.Academic Research Product Track 소개
오늘 우리는 새로운 Academic Research product track를 X API v2에 도입합니다. 이 업데이트로 Academic Researcher를 위한 새로운 신청 프로세스가 도입되며, 승인된 신청자는 더 넓은 접근 권한과 고급 기능을 제공하는 Academic Research Project를 부여받게 됩니다.새로운 Academic Research product track을 사용하면 다음 기능을 이용할 수 있습니다.- 현재로서는 Academic Research product track에만 제공되는 새로운 X API v2 full-archive search endpoint
- Standard product track의 Basic access level에서 제공되던 50만 건에서 1,000만 건으로 증가된 post cap
-
recent search, full-archive search, filtered stream에 사용할 수 있는 새로운 필터 연산자:
$(cashtag),bio(filtered stream에서만 사용 가능),bio_name(filtered stream에서만 사용 가능),bio_location(filtered stream에서만 사용 가능),place,place_country,point_radius,bounding_box,-is:nullcast,has:cashtags,has:geo - filtered stream에 대해 Standard product track의 Basic access level에서 제공되던 25개에서 1,000개로 증가된 동시 규칙 한도
- Standard product track의 Basic access level에서 제공되던 512자에서 1,024자로 증가된 쿼리 및 규칙 문자 길이 한도
Reply Settings 필드 추가
오늘 우리는 post 객체에reply_settings라는 새로운 필드를 추가합니다. 이 필드는 post lookup, hide replies, recent search, sampled stream, filtered stream, follows lookup, user post timeline, user mention timeline endpoint를 포함해 포스트를 반환하는 모든 X API v2 endpoint에서 사용 가능하며, 어떤 endpoint에서든 post 객체를 expanding하여 사용할 수도 있습니다.이 필드는 게시물 작성자가 자신의 포스트에 다른 사용자의 답글을 어느 범위까지 허용했는지(전체 공개, 포스트에서 멘션한 사람만, 혹은 자신이 팔로우하는 사람만)를 나타냅니다. reply_settings 필드에서 반환되는 값에는 everyone, mentionedUsers, following이 포함됩니다. 게시물에 대해 별도의 대화 제어가 설정되어 있지 않더라도, 이 필드는 everyone 값을 가진 상태로 post 객체에 포함됩니다.User Post 및 Mention Timeline Endpoint 출시
오늘 우리는 새로운 user post timeline 및 user mention timeline endpoint를 X API v2에 출시합니다. 이 endpoint들은 특정 X 계정이 작성한 포스트나 해당 계정을 멘션한 포스트를 요청할 수 있도록 해줍니다. 자세한 내용은 포럼 공지 포스트에서 확인할 수 있습니다.Follows Lookup Endpoint 출시
오늘 우리는 새로운 follows lookup endpoint를 X API v2에 출시합니다. 이 endpoint들은 user ID를 사용하여 계정을 팔로우하는 사용자와 그 계정이 팔로우하는 사용자를 조회할 수 있도록 해줍니다. 자세한 내용은 포럼 공지 포스트에서 확인할 수 있습니다.Labs v2 엔드포인트 사용 중단
Labs v2 최신 검색 및 답글 숨기기 엔드포인트 사용 중단다음 엔드포인트의 사용을 중단했습니다. 이 엔드포인트의 Labs 버전을 사용하고 있었다면, 연결된 마이그레이션 가이드를 활용해 통합을 업데이트하고 새로운 X API v2 버전으로 전환할 수 있습니다:또한 migration hub를 통해 새로운 X API v2로 마이그레이션하는 방법에 대한 추가 세부 정보를 확인할 수 있습니다.질문이 있으시면 Labs 포럼 카테고리를 통해 문의해 주세요.Labs v1 엔드포인트 사용 중단
2020년 8월 12일, 저희는 새로운 X API v2 Early Access를 출시했습니다. 이 릴리스와 함께 여러 엔드포인트를 Labs 프로그램에서 X API v2로 승격했으며, 해당 엔드포인트의 Labs 버전은 60일 동안 사용 중단(deprecated) 상태로 유지된 후 사용을 중단할 것이라고 발표했습니다.오늘은 출시 후 60일이 되는 날로, 다음 엔드포인트의 사용을 중단했습니다. 이 엔드포인트의 Labs 버전을 사용 중이라면, 연결된 마이그레이션 가이드를 활용해 통합을 업데이트하고 새로운 X API v2 버전으로 전환할 수 있습니다:또한 migration hub를 통해 새로운 X API v2로 마이그레이션하는 방법에 대한 추가 세부 정보를 확인할 수 있습니다.질문이 있으시면 Labs 포럼 카테고리를 통해 문의해 주세요.포스트 사용 현황 표시줄 추가
새로운 개발자 콘솔의 메인 대시보드 페이지에서 월 500,000개의 포스트 post cap 대비 사용량을 확인할 수 있게 되었습니다. 이 한도는 Basic 액세스에서 다음 v2 엔드포인트 전체에 대해 Project 단위로 적용됩니다: filtered stream, recent search.이 기능을 확인하고 새로운 v2 엔드포인트를 사용하려면, 새로운 개발자 콘솔 환경을 활성화해야 합니다.Hide Replies 엔드포인트 출시
오늘 v2 X API에 새로운 hide replies 엔드포인트를 출시했습니다. 이 엔드포인트를 사용하면 게시물에 대한 욕설, 방해, 오해를 유도하는 답글을 숨길 수 있으며, 이는 공적 대화의 건전성을 개선하는 데 중요한 요소입니다. 자세한 내용은 포럼 게시물 공지에서 확인할 수 있습니다.X Developer Labs의 동일한 엔드포인트는 이제 사용 중단(deprecated) 상태이며, 90일 후 사용이 완전히 중단됩니다. v2 엔드포인트로 마이그레이션하는 방법을 확인하세요.X API v2 엔드포인트 Early Access
오늘 새로운 X API의 첫 번째 엔드포인트에 대한 Early Access를 발표했습니다!새로운 X API는 새로운 API 기반 위에서 동작하여 더 빠르게 새로운 기능을 제공할 수 있으며, 어떤 필드를 받을지에 대해 더 세밀하게 제어할 수 있는 업데이트된 데이터 형식과 기능, 새로운 게시물·사용자·미디어 필드, 그리고 다음과 같이 게시물을 수신하고 분석할 수 있게 해 주는 업데이트된 엔드포인트 세트를 제공합니다:사용 가능한 새 기능의 전체 목록과 마이그레이션 리소스는 X API v2: Early Access 문서 페이지에서 확인할 수 있습니다.향후 계획에 대해서는 X API의 미래 가이드에서 더 알아보세요.Labs 엔드포인트 사용 중단
이번 릴리스에서 X API v2 대체 엔드포인트가 출시됨에 따라 일부 Labs 엔드포인트의 사용을 중단합니다.다음 Labs v1 엔드포인트는 오늘 릴리스일로부터 60일 후에 사용이 종료됩니다.- 게시물 메트릭 v1
- 필터 스트림 v1
- 샘플 스트림 v1
- 최근 검색 v2
새로운 게시물 메트릭 추가
오늘 X Developer Labs 게시물 조회 엔드포인트의 게시물 객체에 두 가지 새로운 비공개 메트릭 하위 필드인user_profile_clicks와 url_link_clicks를 추가합니다. 이 필드들은 다음 값 중 하나와 함께 tweet.fields 파라미터를 사용할 때 반환됩니다: non_public_metrics, organic_metrics, promoted_metrics.더 자세한 내용은 게시물 조회 API 참조 문서를 방문해 주세요.오가닉 및 프로모션 메트릭 그룹
게시물 조회 엔드포인트의 게시물 및 미디어 객체에organic_metrics와 promoted_metrics를 추가합니다.Replay API 사용자 프로필 업데이트
오늘부터 Replay API는 Replay API가 실행되는 시점의 참조된 사용자를 반영하는 사용자 프로필 객체를 제공합니다. 최신 사용자 프로필 객체를 제공하도록 하는 이 변경 사항은 아래 2019년 11월 25일의 최근 Historical PowerTrack 업데이트와 유사합니다.Developer Policy 업데이트
오늘 중요한 Developer Policy 업데이트를 발표했습니다. 포럼 및 블로그 게시물을 통해 자세한 내용을 확인하고, 개정된 정책을 검토하시기 바랍니다. Developer Policy는 X API 사용을 위한 핵심 기반 중 하나이며, 자신의 의무를 이해하는 것이 중요합니다.v2 Labs 엔드포인트 출시
오늘 우리는 포스트 및 Users, Recent Search, Hide Replies 엔드포인트를 Labs v2에 도입합니다. Labs v1 엔드포인트는 사용 중단(deprecate)될 예정이며, 이 최초 출시일로부터 90일 후 완전히 폐기됩니다. 이 기간 동안 v1 문서는 계속 제공됩니다. 이 버전 관리 전략에 대한 의견은 피드백 채널을 통해 보내실 수 있습니다.포스트 및 Users에 대해 다음과 같은 변경 사항을 적용합니다:- 쿼리 매개변수로 fields 도입
- 쿼리 매개변수로 사용되던 formats 제거
- 포스트 및 Users에서 단일 ID lookup을 위한 경로 변수 추가
- GET /users에서 단일 및 여러 사용자 이름 lookup을 위한 경로 및 쿼리 매개변수 조정
-
필드 이름
stats를public_metrics로 변경
-
Users에서
most_recent_tweet_id확장 제거 -
해당 필드를 더 쉽게 파싱할 수 있도록 포스트의
source필드에서 HTML 태그 제거
Access Token 관리 변경
오늘 우리는 developer.x.com의 applications Dashboard에서 Access Token 및 Access Token Secret이 표시되고 관리되는 방식을 변경합니다.API 통합을 더 안전하게 하기 위해, 이 값들이 처음 생성된 이후에는 Dashboard에서 Access Token 및 Access Token Secret을 더 이상 표시하지 않습니다.처음 한 번 이후에는 이러한 자격 증명을 다시 조회할 수 없습니다. Dashboard에서 토큰을 재생성할 수는 있지만, 이 경우 현재 토큰과 secret은 무효화됩니다.이 변경에 대해 더 자세한 내용은 포럼 공지에서 확인하실 수 있습니다.Labs에서 Recent Search 엔드포인트 출시
오늘 우리는 최근 7일 동안 게시된 포스트를 검색하기 위한 새로운 엔드포인트를 출시합니다.이 출시와 관련된 더 자세한 내용은 포럼 공지를 통해 확인하세요.Historical PowerTrack 사용자 프로필 업데이트
오늘부터 “batch historical posts” 엔드포인트(Historical PowerTrack)를 업데이트하여, 작업이 처리될 당시의 값을 반영하는 사용자 프로필 위치, 자기소개(bio) 설명 및 표시 이름 정보를 제공합니다. 업데이트된 사용자 객체가 전달될 때 User/Actor 객체에는 새로운 “updated” 문자열 배열이 포함됩니다.가능한 값은 최대 세 가지입니다: name, description, location:"updated": ["name", "description", "location"]자세한 내용은 Historical PowerTrack 데이터 형식에 대한 문서를 참고하세요.Labs에서 샘플 스트림 엔드포인트 출시
오늘부터 모든 공개 포스트의 샘플을 실시간으로 스트리밍하는 새로운 엔드포인트를 출시합니다.이 출시와 관련된 자세한 내용은 포럼 공지를 참고하세요.Labs에서 필터링된 스트림 엔드포인트 출시
오늘부터 X Developer Labs에서 포스트를 가져오기 위한 새 스트리밍 엔드포인트와, 필터를 관리하기 위한 엔드포인트를 출시합니다. 이러한 엔드포인트를 사용하면 월 최대 500,000개의 포스트(초당 최대 50개의 포스트)를 가져올 수 있으며, 스트림에 최대 10개의 필터 규칙을 설정할 수 있습니다(이 규칙들은 동시에 적용될 수 있습니다).이 출시와 관련된 자세한 내용은 포럼 공지를 참고하세요.API 참조 문서 페이지에 문서화된 요청 매개변수는 이제 선택 사항인지 필수인지 명확하게 표시됩니다. 추가로, 요청에서 JSON 본문 페이로드를 허용하는 경우에는 API 참조 문서 페이지에서 해당 JSON 본문 페이로드가 설명됩니다.Labs에서 포스트 메트릭 출시
이제 소유/승인된 계정의 단일 포스트 또는 포스트 목록에 대한 참여 데이터를 가져올 수 있습니다. 조회할 포스트는 30일 이내에 작성된 것이어야 하며, 리포스트일 수는 없습니다.GET /tweets/metrics/private는 다음 메트릭을 지원합니다:-
impressions -
reposts -
quotes -
likes -
replies -
video views -
video view quartiles(요청자가 해당 미디어의 작성자인 경우)
고정 게시물 확장 추가
pinned_tweet_id는 사용자 객체 확장을 통해 사용자의 고정 게시물을 확장합니다.인용 수 메타데이터 추가
개발자는 새로운 Labs 엔드포인트를 사용하여 인용 수를 가져올 수 있습니다.새로운 Account Activity API 엔드포인트
오늘부터 application-only OAuth를 사용하여 사용자 구독을 비활성화할 수 있는 새로운 Account Activity API 엔드포인트를 도입합니다.이 새로운 엔드포인트를 사용하면 구독된 사용자의 액세스 토큰 없이 Bearer 토큰만 제공해도 구독을 비활성화할 수 있어 개발자가 더 편리하게 작업할 수 있습니다.즉시, 3-Legged OAuth를 사용하여 사용자 구독을 비활성화하는 기존 엔터프라이즈 Account Activity API 엔드포인트를 사용 중단 예정(deprecated) 상태로 표시합니다. 이 엔드포인트는 2020년 1월 15일부터 폐기되며 더 이상 사용할 수 없습니다.개발자는 이 API에 대해 문서에서 더 자세히 알아볼 수 있습니다.Tweets 엔드포인트용 새로운 확장
[GET /tweets]https://developer.x.com/en/docs/labs/tweets-and-users/api-reference/get-tweets.html) 엔드포인트에 두 개의 새로운 확장을 추가했습니다:entities.mentions.username은 게시물에서 인식된 사용자 멘션의 username을 전체 사용자 객체로 확장합니다.referenced_tweets.id.author_id는, 요청된 게시물 중 하나가 리포스트, 인용 게시물 또는 답글인 경우, 참조된 게시물 작성자의 ID를 확장합니다. 이 확장은 또한 참조된 게시물 ID를 전체 객체로 확장합니다.Labs에서 Tweets 및 Users 엔드포인트 지원
처음 두 개의 엔드포인트가 이제 Labs 포털을 통해 사용 가능합니다. 이 엔드포인트들을 사용하려면 승인된 개발자 계정이 있고 Labs 액세스를 신청하여 승인을 받아야 합니다.v1.1에 해당하는 기능과의 주요 차이점은 다음과 같습니다:- 단일 객체 “show” 기능과 일괄 “lookups”를 위한 단일 엔드포인트
- [Expansion parameters])를 통해 하나의 요청으로 추가 객체(예: 멘션된 사용자, 참조된 게시물 등)를 포함하는 기능 지원
- [Format parameters])를 통해 더 많거나 적은 정보를 담는 다양한 데이터 표현 방식 지원
- 인증 방식(사용자 컨텍스트 또는 Bearer 토큰)에 관계없이 앱 수준에서 요청 제한이 적용됨
Account Activity Replay API 출시
오늘부터 엔터프라이즈 티어에서 제공되는 데이터 복구 도구인 Account Activity Replay API를 도입합니다. 이 도구는 Account Activity API의 엔터프라이즈 티어에서 사용할 수 있습니다.Account Activity Replay API를 사용하면 최대 5일 전까지의 이벤트를 조회할 수 있습니다. 이는 webhook 서버가 이벤트를 수신하지 못한 경우 등의 시나리오에서 데이터를 복구하는 데 활용해야 합니다.개발자는 이 API에 대해 문서에서 더 자세히 알아볼 수 있습니다.is:reply 연산자 추가
오늘부터 is:reply 연산자를 enterprise search APIs 및 유료 버전의 premium search endpoints에서 사용할 수 있습니다.is:reply 불리언 연산자는 모든 게시물에 대한 답글만 필터링하거나, 규칙과 일치하는 명시적인 답글만 걸러내는 데 사용할 수 있습니다. 이 연산자는 is:quote 연산자와 동일한 방식으로 동작합니다.Search API를 사용할 때는 모든 ‘is:’ 및 ‘has:’ 연산자를 키워드나 해시태그와 같은 단독 연산자와 함께 사용해야 한다는 점에 유의해야 합니다.이 연산자에 대해서는 문서에서 더 자세히 알아볼 수 있습니다.확장 URL Enrichment 변경 사항
오늘부터 확장 URL enrichment에는 게시물, Moments, 또는 프로필로 연결되는 URL에 대해, unwound URL 객체와 메타데이터(title 및 description 필드 포함)가 더 이상 포함되지 않습니다. 웹사이트 등으로 연결되는 다른 URL은 계속해서 이 메타데이터로 보강되며, url, expanded_url, 그리고display_url은 여전히 사용할 수 있다는 점에 유의하세요. 이 변경 사항은 Decahose, PowerTrack, Historical PowerTrack, 그리고 Search APIs에 적용됩니다.PowerTrack의 is:reply 연산자 추가
오늘은 여러분이 가장 중요하게 생각하는 대화로 범위를 좁힐 수 있도록 새로운 연산자 is:reply를 소개합니다. 이제 결과에서 답글을 필터링해 제외할 수 있습니다(이미 제공되던 리포스트 필터링 기능인 is:retweet 및 인용 게시물 필터링 기능인 is:quote에 더해 사용할 수 있습니다). 이 새로운 연산자는 오늘부터 PowerTrack, Historical PowerTrack, 그리고 Replay에서 사용할 수 있습니다.is:reply 불리언 연산자는 모든 포스트에 대한 답글만 필터링하거나, 규칙과 일치하는 명시적인 답글을 제외하는 데 사용할 수 있습니다. 이 연산자는 is:quote 연산자와 동일한 방식으로 동작합니다.이 연산자에 대한 자세한 내용은 문서에서 확인할 수 있습니다.비디오 자막 지원
오늘 우리는 광고주와 퍼블리셔가 이제 ads.x.com, Media Studio, 그리고 퍼블리셔 업로드 API를 통해 동영상에 자막 파일(SRT)을 추가할 수 있게 되었음을 발표합니다. 자막은 Android 및 Web에서 자동 재생되는 동영상(소리가 없는 경우)에 표시됩니다. iOS에 대한 기능은 향후 몇 주 안에 출시될 예정입니다.새 자막 엔드포인트에 대해 더 자세히 알아보려면 각각의 API 참조 문서를 확인하세요.Account Activity API 엔드포인트 업데이트
오늘 우리는 Account Activity API 엔드포인트인 GET subscriptions/count의 업데이트를 발표합니다. 청구 세부 정보와 API 사용량을 더 명확하게 파악할 수 있도록, 오늘부터는 JSON 내에서 Account Activity API 인스턴스와 연결된 프로비저닝된 subscription 수를 프로그래밍 방식으로 가져올 수 있습니다. 이는 이제 GET subscriptions/count API 엔드포인트를 통해 프로비저닝된 subscription 수와 해당 한도에 얼마나 근접했는지를 모두 확인할 수 있음을 의미합니다.이 업데이트는 Account Activity API 문서에 반영되어 있습니다.POST 엔드포인트에 대한 새로운 요청 한도
오늘부터 여러 표준 POST 엔드포인트에 앱 단위 요청 한도를 새로 적용합니다:- POST statuses/update
- POST statuses/retweet/:id
- POST favorites/create
- POST direct_messages/events/new
- POST friendships/create
twitter-text 라이브러리 업데이트
오늘 우리는 X에서 이모지 글자 수를 계산하는 방식에 최근 적용된 변경 사항을 반영하기 위해 twitter-text 라이브러리를 업데이트했음을 알립니다. 이전에 어떤 이모지는 두 글자보다 많이 계산되었다면, 이제는 280자 제한 안에서 사용자가 최대한 많은 문자를 사용할 수 있도록 두 글자로만 계산됩니다.이 변경 사항에 대해서는 포럼 공지에서 더 자세히 확인할 수 있습니다.DM 미디어 액세스 변경
오늘부터 다이렉트 메시지에서 첨부 미디어를 가져오는 프로세스에 일부 변경을 적용합니다. 더 이상 인증된 www.x.com 세션을 통해media_url 또는 media_url_https에 접근하는 방식은 지원하지 않습니다. media_url_https를 가져오기 위한 요청은 항상 OAuth 1.0A를 사용해 사용자의 액세스 토큰으로 서명되어야 합니다.이 업데이트에 대해서는 포럼 공지를 통해 더 알아볼 수 있습니다.User Streams 및 Site Streams 사용 중단
User Streams와 Site Streams를 완전히 사용 중단했습니다.이 업데이트에 대해서는 포럼 공지를 통해 더 알아볼 수 있습니다.Usage API의 새 버전
오늘 새로운 버전의 Usage API를 출시합니다. 이번 업데이트로 새로운 시스템으로 이전하여 API의 안정성을 높이고자 합니다.시스템 업데이트로 인해, 개발자가 2018년 5월 1일까지의 데이터만 조회할 수 있기 때문에 사용자들은 데이터의 “공백 구간”을 경험하게 됩니다. 따라서 앞으로 1년 동안(2019년 6월까지) 몇 개월 치의 과거 데이터가 누락됩니다.Usage API 내의 제품 이름이 Historical PowerTrack Subscription에서 Historical PowerTrack 2.0으로 변경되어, 다른 사용자 대상 용어와 제품 명칭이 일관되도록 조정됩니다. 업데이트 이후에도 고객은 동일한 형식의 동일한 데이터를 받게 됩니다. 이 변경 사항은 products.type JSON 객체에서 확인할 수 있습니다.궁금한 점이 있으시면 계정 담당자에게 문의해 주시기 바랍니다.API 지원 종료
Account Activity API DM Beta 제품은 오늘부로 완전히 지원이 종료되었습니다.다음 서비스와 엔드포인트는 오늘부터 서비스 품질 저하가 발생합니다.- User Streams
- Site Streams
- GET direct_messages
- GET direct_messages/sent
- GET direct_messages/show
- POST direct_messages/new
- POST direct_messages/destroy
App 생성 및 요청 한도 변경
오늘부로 apps.x.com을 통해 새로운 X apps를 생성할 수 없습니다. 이제는 개발자 콘솔 계정으로 리디렉션되거나, 아직 개발자 콘솔 계정이 없는 경우 접근 권한을 신청할 수 있는 페이지로 이동하게 됩니다.또한 2018년 9월 10일부터 다음 POST 엔드포인트에 대해 새로운 App 수준 요청 한도를 적용할 예정임을 발표했습니다.- POST statuses/update
- POST statuses/retweet:id
- POST friendships/create
- POST favorites/create
- POST direct_messages/events/new
개발자 콘솔에서 App 관리
개발자 콘솔 계정이 있다면 이제 X App을(를) 생성하고 관리할 수 있습니다. 자세한 내용은 [포럼 게시물](https://devcommunity.x.com/t/app-creation-and-management-now-available-in-the-Developer Console/107723)을 읽어보세요.Sign in with X 및 Account Activity 변경 사항
오늘부터 Sign in with X 프로세스에서 사용하는 callback URL을(를) 등록해야 합니다. 이 업데이트에 대해 더 자세히 알고 싶다면 여기를 참조하세요.또한 Account Activity API에 tweet_delete_events activity를 추가했다고도 발표했습니다. 이 새로운 activity는 해당 삭제 이벤트에 대해 전송되어, 개발자가 고객 및 애플리케이션 사용자에게 보다 쉽게 규정을 준수하는 경험을 제공할 수 있도록 돕습니다. 이 새로운 activity에 대한 자세한 내용은 포럼 게시물 또는 문서에서 확인할 수 있습니다.Klout 데이터 제거
오늘 우리는 GDPR 업데이트의 일환으로 게시물 payload에서 모든 Klout 데이터를 제거했습니다.프로필 배경 및 Account Activity 변경 사항
오늘부터 profile_background_image_url 및 profile_background_image_url_https의 모든 인스턴스를 기본값으로 변경합니다. 자세한 내용은 포럼 게시물을 읽어보세요.위 변경 사항에 더해, 어떤 구독에 대해 activity가 전달되었는지 참조하기 위해 Account Activity API payload에 새 필드를 추가하고 있습니다. 이 JSON 객체의 이름은 for_user_id이며, 해당 activity를 생성한 구독된 사용자의 id를 값으로 포함합니다. 이 새로운 JSON 객체의 몇 가지 예시는 account activity objects 페이지에서 확인할 수 있습니다.인용 페이로드 렌더링 변경
오늘 우리는 인용 페이로드에서 URL이 렌더링되는 방식을 변경합니다.인용된 게시물을 참조할 수 있도록 “quoted_status_permalink”라는 새 엔티티를 추가하고, 인용된 게시물의 “text” 필드에서 t.co 링크를 제거할 예정입니다.새로운 형식에서는 “quoted_status” 오브젝트에서 인용된 게시물의 “text” 필드에 더 이상 t.co 링크가 추가되지 않습니다.또한 더 이상 인용된 게시물의 t.co url, expanded_url, display_url을 “urls” 엔티티에 넣지 않습니다. 대신, 이러한 값들은 “url”, “expanded”, “display” URL 속성을 가진 새로운 “quoted_status_permalink” 오브젝트에 추가됩니다. 이는 “quoted_status_permalink” 오브젝트는 인용된 게시물로 돌아가는 t.co 링크에만 사용되고, “entities.urls” 배열은 원본 게시물 또는 인용 게시물 내에서 공유된 링크를 식별하는 데 사용할 수 있음을 의미합니다.자세한 내용은 포럼 글과 업데이트된 문서를 읽어보세요.Additional Media Info 오브젝트 추가
게시물 페이로드에 새로운 오브젝트인 additional_media_info 오브젝트가 추가되었으며, 또한 광고주가 동영상 재생을 X가 소유한 클라이언트로 제한해 달라고 요청한 프로모션 게시물의 경우 일부 동영상 세부 정보(video_info)가 제한되었습니다. 이 변경 사항에 대한 추가 정보는 다음 링크에서 확인할 수 있습니다: Extended Entities Objects > post with native video.Premium 전체 보관 검색 출시
premium 전체 보관 검색 엔드포인트를 출시했습니다.Account Activity API 출시
(All Activities)와 (다이렉트 메시지) Standard 베타 Account Activity API를 모두 출시했으며, 이에 대한 자세한 내용은 블로그에서 확인할 수 있습니다. 또한 User streams와 Site streams의 지원 중단과 2018년 6월 19일 화요일 서비스 종료 날짜를 발표했습니다.Premium API 출시
Premium API를 출시했습니다.이 새로운 API는 엔터프라이즈 데이터 플랫폼의 품질과 안정성을 기반으로 하며, 계층형 과금 모델을 통해 더 폭넓게 제공됩니다. 표준 엔드포인트에서 제공하던 7일치 데이터의 제한을 넘어 처음으로 최대 30일치 게시물을 검색할 수 있고, 선택적으로 프로필 지오 정보, URL 확장, 투표 데이터에 대한 프리미엄 보강 데이터에도 접근할 수 있습니다. 새 기능의 일부는 다음과 같습니다:- 요청당 더 많은 게시물(Sandbox + Premium)
- 더 복잡한 쿼리를 작성할 수 있게 해 주는 훨씬 강력한 쿼리 언어(Sandbox + Premium)
- 게시물 수에 대한 시계열 집계를 반환하는 counts 엔드포인트(Premium)
- 확장된 URL, Profile Geo 등의 메타데이터 보강(Premium)
Additional Media Info 추가
게시물 페이로드에 새로운 데이터(additional_media_info object)를 추가하고, 광고주가 동영상 재생을 X가 소유한 클라이언트로 제한해 달라고 요청한 프로모션 게시물에 대해서는 일부 동영상 세부 정보(video_info)를 제한합니다. 이 변경 사항에 대한 추가 정보는 다음 링크에서 확인할 수 있습니다: Extended Entities Objects > post with native video30일 Search에서 url_contains 연산자 지원 종료
30일 및 전체 보관(Full-Archive) Search에서 url_contains: 연산자 지원이 종료되었습니다. 이 연산자의 사용 중단은 2016년 8월 Gnip 2.0 마이그레이션의 일부로 공지되었습니다. url_contains: 연산자를 사용하는 모든 Search 쿼리는 잘못된 것으로 간주되어 거부됩니다.Search API에서 url_contains 연산자 제거 예정
30일 Search API(30일 및 전체 보관 모두)는 오늘로부터 30일 후, 즉 2017년 8월 4일 이후부터 url_contains: 연산자를 더 이상 지원하지 않습니다(url_contains: 지원은 실제로 해당 날짜 이후 첫 배포 시 종료됩니다). 이 연산자의 사용 중단은 2016년 8월 Gnip 2.0 마이그레이션의 일부로 공지되었습니다. 연산자 지원이 종료되면, url_contains:를 사용하는 모든 쿼리는 잘못된 것으로 간주되어 거부됩니다.DM 명령에 대한 선택적 매개변수
statuses/update에 대한 선택적enable_dm_commands 매개변수는 애플리케이션이 전환 기간이 끝나기 전에 DM 명령 지원을 조기에 제거할 수 있도록 해 줍니다. 기본값은 true(현재 레거시 동작)이지만, false로 설정하면 11월 1일 이후의 새로운 동작을 사용할 수 있습니다. statuses/update에 대한 선택적 fail_dm_commands 매개변수를 true로 설정하면 DM 명령이 API에서 HTTP 403(오류 코드 151)을 반환하게 됩니다. 기본값은 false입니다. 이 업데이트에 대한 자세한 내용은 포럼 글을 참고하세요.새로운 Enrichment 및 페이로드 변경
새로운 Enrichment! 이제 설문조사 메타데이터를 엔터프라이즈 API를 통해 사용할 수 있습니다. 자세한 내용은 문서를 참고하세요.새로운 페이로드 필드: 사용자가 게시물에 사진을 추가할 때 “Add description” 옵션을 선택한 경우, 페이로드의 entities.media[] 및 extended_entities.media[] 섹션에 이미지 대체 텍스트(설명) 필드가 존재할 수 있습니다. 이는 향상된 네이티브(enriched native) 형식에서만 사용할 수 있습니다.기본 페이로드 형식: 이제 Gnip 제품에서 새로 생성되는 스트림은 기본적으로 original 형식 JSON을 사용합니다.Historical PowerTrack 및 Replay API 업데이트
Historical PowerTrack API 및 Replay API- 이제 인용(quote) 필터링을 지원합니다
- 인용된 포스트가 이제 HPT 및 Replay 포스트 페이로드에서 완전한 형태로 재구성(rehydrate)됩니다
카운트를 위한 새로운 페이로드 필드
새로운 페이로드 필드인 quote_count 및 reply_count가 이제 Realtime 및 Historical API 전반에 걸쳐 네이티브 enriched 형식의 페이로드에서 제공됩니다전체 보관 검색에서 Geo 연산자 지원
Full-Archive Search API (FAS):- 다음과 같은 추가 geo 연산자를 지원합니다:
- place:
- place_country:
- has:profile_geo:
- profile_country:
- profile_region:
- profile_locality: