Twitter API

이 서비스는 통합 Twitter REST API를 제공합니다. 호출자는 일관된 X API v2 스타일의 응답 구조를 받습니다.

/v1/twitter

인증

모든 Twitter API 엔드포인트에는 Bearer 토큰 인증이 필요합니다.

Authorization: Bearer YOUR_API_KEY

기본 경로

API 기본 URL 아래에서 이 상대 경로를 호출하세요.

GET https://api.apihop.ai/v1/twitter/users
GET https://api.apihop.ai/v1/twitter/users/{id}
GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

응답 구조

성공한 Twitter 응답은 success/data로 감싸지 않으며 정규화된 data, includes, meta 필드를 직접 반환합니다.

지원 기능

권장 흐름

1. username만 있다면 먼저 사용자 이름으로 사용자를 조회하고 data.id를 읽으세요.
2. data.id로 사용자 타임라인을 조회하세요.
3. 타임라인 응답에 작성자 프로필이 필요하면 expansions=author_id를 전달하세요.

정규화 규칙

• 사용자 엔드포인트는 하나의 사용자 객체를 반환합니다: { "data": { ... } }
• 타임라인 엔드포인트는 트윗 배열을 반환합니다: { "data": [ ... ], "meta": { ... } }
• expansions=author_id를 요청하면 타임라인 응답에 includes.users가 포함됩니다
• user.fields와 tweet.fields는 선택적 필드 투영을 제어합니다
• 사용자 객체는 항상 id, name, username을 유지합니다
• 트윗 객체는 항상 id와 text를 유지합니다

선택적 필드

user.fields

지원되는 정규화된 사용자 필드:

• created_at
• description
• entities
• location
• pinned_tweet_id
• profile_banner_url
• profile_image_url
• protected
• public_metrics
• url
• verified
• verified_type

tweet.fields

지원되는 정규화된 트윗 필드:

• attachments
• author_id
• conversation_id
• created_at
• edit_history_tweet_ids
• entities
• in_reply_to_user_id
• lang
• possibly_sensitive
• public_metrics
• referenced_tweets
• source

디버깅

• 모든 응답에 X-Request-Id가 포함됩니다
• 호출 실패, 비정상 결과 또는 속도 제한 발생 시 이를 기록하세요
• 청구 문의 시 X-Request-Id와 요청 시각을 보관하세요

엔드포인트