Skip to main content
이 가이드는 첫 X API 요청을 보내는 과정을 안내합니다. 시작하기 전에 앱 자격 증명이 있는 개발자 계정이 필요합니다.

​
cURL로 빠르게 시작하기

API를 테스트하는 가장 빠른 방법은 cURL입니다. 사용자를 조회해 봅시다: 
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
$BEARER_TOKEN을 실제 Bearer Token으로 바꾸세요. 다음과 같은 응답을 받게 됩니다: 
{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

​
단계별 가이드

1

Bearer Token 받기

Developer Console에서 앱으로 이동해 Bearer Token을 복사하세요.
2

엔드포인트 선택

다음 입문자 친화적인 엔드포인트 중 하나로 시작하세요:
엔드포인트기능
User lookup사용자명 또는 ID로 사용자 프로필 가져오기
Post lookupID로 게시물 가져오기
Recent search최근 7일간의 게시물 검색
3

요청 보내기

cURL, Postman 또는 선호하는 HTTP 클라이언트를 사용하세요:
# Look up a user by username
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
4

응답 파싱

응답은 JSON 형식입니다. 기본 데이터는 data 필드에 있습니다:
{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

​
fields로 더 많은 데이터 요청하기

기본적으로 엔드포인트는 최소한의 필드만 반환합니다. 추가 데이터를 요청하려면 fields 매개변수를 사용하세요: 
curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"
응답: 
{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X Developer Platform",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}
fields에 대해 자세히 알아보기 →

​
더 많은 예제

curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
cURL 대신 코드 사용하기

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/users/by/username/xdevelopers"

headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers)

print(response.json())

​
테스트 도구

Postman

컬렉션으로 시각적 API 테스트를 수행합니다.

샘플 코드

여러 언어로 된 예제입니다.

API 레퍼런스

전체 엔드포인트 문서입니다.

​
문제 해결

  • Bearer Token이 올바른지 확인하세요
  • 토큰이 재발급되지 않았는지 확인하세요
  • Authorization 헤더 형식을 확인하세요: Bearer YOUR_TOKEN
  • 앱에 이 엔드포인트 액세스 권한이 없을 수 있습니다
  • 일부 엔드포인트는 사용자 컨텍스트 인증(OAuth 1.0a 또는 2.0)이 필요합니다
  • Developer Console에서 앱의 권한을 확인하세요
  • 속도 제한에 도달했습니다
  • 재시도 시점을 확인하려면 x-rate-limit-reset 헤더를 확인하세요
  • 코드에 지수 백오프를 구현하세요
전체 오류 레퍼런스 →

​
다음 단계

인증 배우기

사용자 컨텍스트 요청을 위한 OAuth를 이해하세요.

엔드포인트 살펴보기

무엇을 만들 수 있는지 알아보세요.

SDK 사용

공식 라이브러리로 더 빠르게 개발하세요.

무언가 만들기

무엇을 만들지에 대한 아이디어입니다.