Skip to main content

​
좋아요 조회: standard v1.1과 X API v2 비교

standard v1.1 GET favorites/list 엔드포인트를 사용해 오고 계셨다면, 이 가이드는 standard v1.1과 X API v2 좋아요 조회 엔드포인트 간의 공통점과 차이점을 이해하는 데 도움을 드리는 것을 목표로 합니다. v2에서는 게시물을 좋아요한 사용자 정보를 가져올 수 있는 새로운 좋아요한 사용자 조회 엔드포인트도 도입했습니다.
  • 유사점
    • 인증
    • 요청 한도
  • 차이점
    • 엔드포인트 URL
    • 요청 제한 사항
    • App 및 Project 요구 사항
    • 요청 파라미터
    • 새로운 JSON 형식

​
유사점

인증 표준 v1.1과 X API v2의 Likes 조회 엔드포인트는 모두 OAuth 1.0a User Context 또는 OAuth 2.0 Bearer Token을 사용합니다. 따라서 이전에 표준 v1.1 GET favorites/list 엔드포인트를 사용해 왔다면, 원할 경우 X API v2 버전으로 마이그레이션하더라도 동일한 인증 방법을 계속 사용할 수 있습니다.  선호하는 인증 라이브러리/패키지에 따라 다를 수 있지만, Bearer 토큰 인증이 시작하기에 가장 간단한 방법인 경우가 많으며, 간단한 요청 헤더 설정만으로 사용할 수 있습니다. Bearer 토큰을 생성하는 방법을 알아보려면 이 OAuth 2.0 Bearer Token 가이드를 참조하세요.    요청 한도 표준 v1.1 GET favorites/list 엔드포인트에는 사용자당 15분에 75회라는 요청 한도가 있습니다. v2에서 이에 해당하는, 사용자가 좋아요한 포스트(liked Posts)를 조회하는 엔드포인트에도 동일한 요청 한도가 적용됩니다. 다만 이 v2 엔드포인트에는 App당 15분에 75회라는 추가 요청 한도도 있습니다.

​
차이점

엔드포인트 URL 요청 제한 사항 v2 liked Posts 엔드포인트에서는 요청당 5개에서 100개의 포스트를 요청할 수 있지만, 페이지네이션 토큰을 사용하면 하나의 게시물에 대한 모든 좋아요를 요청할 수 있습니다. v1.1 GET favorites/list 엔드포인트 역시 게시물에 대한 모든 좋아요를 가져올 수 있지만, 요청당 20개에서 200개의 포스트를 가져올 수 있습니다. v2 liking users 엔드포인트의 경우, 게시물당 최대 100명의 좋아요한 사용자만 조회할 수 있습니다.    App 및 Project 요구 사항 X API v2 엔드포인트를 사용하려면 요청을 인증할 때 developer App이 Project와 연결되어 있는 App의 자격 증명을 사용해야 합니다. X API v1.1의 모든 엔드포인트는 Project에 연결되지 않은 App이나 Project와 연결된 App 어느 쪽의 자격 증명도 사용할 수 있습니다. 요청 파라미터 다음 표준 v1.1 요청 파라미터는 두 개의 쿼리 파라미터(user_id 또는 screen_name)를 받을 수 있었습니다. X API v2는 숫자 사용자 ID만 허용하며, 이는 엔드포인트 경로의 일부로 전달되어야 합니다. 표준 v1.1과 X API v2 엔드포인트 버전 간의 가장 큰 차이점 중 하나는 페이로드에 어떤 필드를 반환할지 선택하는 방식입니다. 표준 엔드포인트에는 페이로드에 어떤 필드 또는 필드 집합을 반환할지 지정하기 위해 사용할 수 있는 다양한 파라미터가 있었던 반면, X API v2 버전에서는 이러한 서로 다른 파라미터를 fields 및 expansions로 단순화했습니다.    새 JSON 형식 X API v2는 API가 반환하는 객체에 대해 새 JSON 설계를 도입하고 있으며, 여기에는 Post 및 user 객체가 포함됩니다.
  • JSON 루트 레벨에서 표준 엔드포인트는 statuses 배열 안에 user 객체를 반환하는 반면, X API v2는 data 배열을 반환합니다. 
  • 리트윗 및 인용 “statuses”를 참조하는 대신, X API v2 JSON은 리트윗된 Tweet 및 인용 Tweet을 참조합니다. contributors 및 user.translator_type과 같은 많은 레거시 및 사용 중단 필드는 제거됩니다. 
  • Post 객체의 favorites와 user 객체의 favourites를 모두 사용하는 대신, X API v2는 like라는 용어를 사용합니다. 
  • X는 null 값인 JSON 값(예: null)은 페이로드에 포함하지 않는 규칙을 채택하고 있습니다. Post 및 user 속성은 null이 아닌 값을 가진 경우에만 포함됩니다.  
새 JSON 형식에 도입한 변경 사항과 더불어, Post 객체에 다음을 포함하는 새로운 필드 집합도 도입했습니다.

​
코드 예제

​
좋아요한 포스트 가져오기 (v2)

cURL
curl "https://api.x.com/2/users/2244994945/liked_tweets?tweet.fields=created_at,public_metrics&max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
좋아요를 누른 사용자 조회 (v2)

cURL
curl "https://api.x.com/2/tweets/1234567890/liking_users?user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"