사용자 이름으로 계정을 조회하고 반환할 프로필 필드를 선택하세요.
Twitter API
Twitter API: 사용자 조회, 타임라인 및 페이지네이션
Bearer 인증, 사용자 및 트윗 필드 선택, 커서 페이지네이션과 유효성 검사 오류 처리로 API Hop Twitter / X 엔드포인트를 연동하세요.
사용자 이름을 사용자 ID로 조회하고 타임라인을 가져온 뒤 반환된 다음 토큰으로 다음 페이지를 요청하세요. 성공한 호출은 JSON을 직접 반환하며 이 엔드포인트에는 Jobs 폴링 단계가 없습니다.
특정 작업을 위해
지원되는 세 가지 GET 작업을 구현하고 결과를 처리하세요.
사용자 이름을 다시 조회하지 않고 사용자 ID로 알려진 계정을 갱신하세요.
페이지 크기 한도와 페이지네이션 토큰으로 타임라인 페이지를 조회하세요.
과금 단위
사용량 측정 방식 확인
요청당 USD.
운영 제한
- 반환 필드는 문서에 명시된 쿼리 매개변수와 상위 응답에 따라 달라집니다.
- max_results는 1~100의 정수여야 합니다. 한 페이지의 결과 수는 더 적을 수 있습니다.
- 숫자 정밀도 손실을 방지하려면 사용자 ID와 트윗 ID를 문자열로 보관하세요.
연동 가이드
다음 단계 선택
현재 카탈로그 범위
사용 가능한 API 및 과금 단위
API ID, 작업, 제공업체 및 가격을 비교하세요. 사용 비용을 추정하기 전에 카탈로그 날짜와 각 작업의 과금 단위를 확인하세요.
공개된 Twitter / X 사용자 프로필과 사용자 타임라인을 조회합니다.
- 제공업체
- Twitter / X Data
- 과금 단위
- 요청
- API 형식 및 엔드포인트
- 요청 엔드포인트는 아래 작업을 참조하세요.
- 공개된 기능
- 사용자 조회, 사용자 타임라인
-
GET /v1/twitter/users사용자 이름으로 사용자 조회 -
GET /v1/twitter/users/{id}사용자 ID로 사용자 조회 -
GET /v1/twitter/users/{id}/tweets사용자 트윗 조회
API Hop 요금
- 요청
- $0.0020 /요청
사용자 이름으로 사용자 조회
GET /v1/twitter/users API Hop 요금
- 요청
- $0.0020 /요청
사용자 ID로 사용자 조회
GET /v1/twitter/users/{id} API Hop 요금
- 요청
- $0.0020 /요청
사용자 트윗 조회
GET /v1/twitter/users/{id}/tweets API Hop 요금
- 요청
- $0.0020 /요청
요청 예시
문서화된 작업부터 시작
curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
-H "Authorization: Bearer <API_KEY>"const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);import requests
url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json()) 계정 문서의 API 기본 URL을 사용하고 예시 자리표시자를 교체하세요. API 키는 Authorization 헤더로 전송하고 URL이나 커밋 파일에 포함하지 마세요.
엔드포인트
계정 및 타임라인을 위한 세 가지 작업
GET /v1/twitter/users?username=<USERNAME> 다음 요청을 위해 반환된 data.id를 문자열로 읽으세요.
GET /v1/twitter/users/<USER_ID> 알려진 계정을 조회하고 필요에 따라 프로필 필드를 선택하세요.
GET /v1/twitter/users/<USER_ID>/tweets max_results를 설정하고 다음 페이지에 pagination_token을 전달하세요.
쿼리 매개변수
필드 선택 및 타임라인 페이지네이션
- 계정 조회
/v1/twitter/users에는username이 필수입니다. 두 조회 엔드포인트 모두description,public_metrics같은 쉼표로 구분된user.fields목록을 허용합니다.- 페이지 크기
max_results는 1~100의 정수를 허용합니다. 페이지 크기의 상한이며 해당 게시물 수를 보장하지 않습니다.- 타임라인 필드
- 시각과 지표에는
tweet.fields=created_at,public_metrics를 사용하세요. 제공되는 작성자 정보가 필요하면expansions=author_id와user.fields를 요청하세요. 해당 게시물 유형을 제외하려면exclude=replies,retweets를 사용하세요. - 다음 페이지
- 응답의
meta.next_token을 다음 요청의pagination_token으로 전달하세요. 토큰을 해석하지 말고 URL 인코딩하세요. 다음 토큰이 없거나 페이지 예산에 도달하거나 토큰이 반복되면 중단하세요.
응답 처리
JSON 결과 직접 읽기
사용자 조회는 data에 계정을 반환합니다. 타임라인 응답에는 data 배열과 meta.result_count가 있으며 다음 커서가 있으면 meta.next_token도 포함됩니다. 작성자 확장 정보는 includes.users에 있을 수 있습니다.
{
"data": [],
"meta": {
"result_count": 0
}
} 빈 타임라인 응답의 예시이며 실제 계정 조회 결과가 아닙니다. 선택 필드와 커서가 없을 수 있습니다. 빈 페이지는 해당 계정이 게시한 적 없다는 증거가 아닙니다.
유효성 검사 오류
재시도 전에 잘못된 매개변수 수정
username이 없거나 max_results가 범위를 벗어나면 success: false, error.code: 10001, error.message, requestId와 함께 HTTP 400을 반환합니다. 같은 요청을 반복하지 말고 메시지를 확인하여 요청을 수정하세요.
요청 추적
인증 정보 대신 요청 ID 보관
지원과 요청 추적을 위해 X-Request-Id 응답 헤더를 보관하세요. 성공 데이터를 읽기 전에 HTTP 상태를 확인하고 API 키와 불필요한 프로필 데이터가 앱 로그에 남지 않도록 하세요.