X (Twitter) 상세 정보 API

Q: 계정의 성장 추이는 어떻게 추적하나요?

일정에 따라 주기적으로 호출하고 follower_count, following_count, post_count를 호출 날짜와 함께 user_id를 키로 저장하세요. 호출 한 번이 스냅샷 하나이므로 시계열의 세밀함은 호출 주기에 달려 있습니다. null 값은 0으로 떨어진 것이 아니라 데이터 공백을 나타냅니다.

POST

API 상태

24시간 상태: 정상
24시간 평균 소요 시간: —

양호 / 정상
사용 가능
제한적
대부분 작동 중단

정상

최근 24시간

최근 30일

X(Twitter) 핸들의 소개, 위치, 팔로워·팔로잉·게시물 수, 인증 여부, 계정 생성일을 확인합니다. 사용자 이름은 @를 붙이거나 빼고 전달할 수 있으며, 프로필 URL은 사용할 수 없습니다. 결과는 신원, 현재 활동 여부, 오디언스 구성을 확인해 주지 않습니다.

X (Twitter) Details는 username으로 X 계정 하나의 공개 프로필을 읽어 단일 레코드를 반환합니다. 레코드에는 user_id, 핸들, 표시 이름, 소개, 위치, 프로필 링크, 아바타, 팔로워·팔로잉·게시물 수, 인증 여부, 계정 생성일이 담깁니다. 마케터, 기자, 애널리스트는 이 기능으로 핸들 뒤에 누가 있는지, 계정의 규모와 활동량이 어느 정도인지 확인합니다. 캠페인 전 크리에이터 검증, 인용 전 공식 계정 확인, 핸들 목록에 오디언스 규모 정보 보강 등에 활용합니다.

display_name은 프로필에 표시되는 이름으로 핸들과 다를 수 있습니다. 따라서 계정은 username으로, 더 정확하게는 X에서 계정의 고유 ID인 user_id로 매칭하세요. 소개에는 줄바꿈과 이모지가 포함될 수 있습니다. follower_count, following_count, post_count가 null이면 수치가 공개되지 않았다는 뜻이고, is_verified가 null이면 인증 여부를 확인할 수 없었다는 뜻입니다.

요금은 요청 1,000개당 $0.56(호출당 $0.000556)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.

AI 프롬프트

EveryInfra X (Twitter) 상세 정보 엔드포인트(twitter/profile)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 twitter, action은 profile로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
- username: X 사용자 이름이며, @ 접두사는 선택이고 프로필 전체 URL은 입력하지 않습니다. profile은 최근 게시물의 작성자 정보에서 데이터를 모으고, followers_list와 following_list는 각각 표시되는 팔로워와 팔로잉 계정을 가져옵니다.
- 단일 객체를 반환합니다. 주요 필드: user_id, username, display_name, bio, url, follower_count, following_count, post_count, is_verified, location, avatar_url, created_at.
- 요청 본문 예시:
{
"platform": "twitter",
"action": "profile",
"params": {
"username": "nasa"
}
}
- 요금: 요청 1,000개당 $0.56. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.

요청 파라미터

이름	위치	타입	필수	기본값	설명
`Authorization`	header	`string`	예	-	Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
`platform`	body	`string`	예	`twitter`	플랫폼 식별자이며 고정값입니다.
`action`	body	`string`	예	`profile`	기능 식별자이며 고정값입니다.
`username`	body.params	`string`	예	-	X 사용자 이름이며, @ 접두사는 선택이고 프로필 전체 URL은 입력하지 않습니다. profile은 최근 게시물의 작성자 정보에서 데이터를 모으고, followers_list와 following_list는 각각 표시되는 팔로워와 팔로잉 계정을 가져옵니다.

코드 샘플

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "twitter",
  "action": "profile",
  "params": {
    "username": "nasa"
  }
}'

OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.

응답 예시

실제 응답

September 26, 2026 at 08:56(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다. id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.

json

{
  "id": "req_…",
  "platform": "twitter",
  "action": "profile",
  "results": {
    "user_id": "•••",
    "username": "NASA",
    "display_name": "NASA",
    "url": "https://x.com/NASA",
    "follower_count": 92375075,
    "following_count": 115,
    "post_count": 74334,
    "is_verified": true,
    "location": "Pale Blue Dot",
    "avatar_url": "https://pbs.twimg.com/•••",
    "created_at": "Wed Dec 19 20:20:32 +0000 2007",
    "platform": "twitter"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

응답 필드

비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.

필드	의미
`user_id`	플랫폼에서 사용자의 고유 ID입니다.
`username`	사용자 이름(@handle)입니다.
`display_name`	표시 이름으로, username과 다를 수 있습니다.
`bio`	계정이 작성한 프로필 소개로, 줄바꿈과 이모지가 포함될 수 있습니다.
`url`	플랫폼에서 해당 레코드로 연결되는 링크입니다.
`follower_count`	팔로워 수입니다. null은 비공개라는 뜻이며, 0이 아닙니다.
`following_count`	팔로잉 수입니다. null은 비공개라는 뜻이며, 0이 아닙니다.
`post_count`	전체 게시물 수입니다. null은 비공개라는 뜻이며, 0이 아닙니다.
`is_verified`	플랫폼의 계정 인증 여부입니다. null은 판단할 수 없다는 뜻입니다.
`location`	위치 설명을 그대로 전달하며, 형식은 플랫폼마다 다릅니다.
`avatar_url`	프로필 이미지 링크입니다. 일부 플랫폼은 크기가 지정된 CDN 링크를 반환하며, 이 링크는 만료될 수 있습니다.
`created_at`	생성 시각으로, posted_at과 같은 형식입니다.
`platform`	출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).

FAQ

`username`에는 무엇을 넘기나요?

프로필 링크에서 x.com/ 뒤에 오는 핸들입니다(예: nasa). 앞에 @를 붙여도 됩니다. 전체 링크나 표시 이름은 넘기지 마세요. 이 필드는 핸들만 받으며, 결과의 display_name은 프로필에 표시되는 별도의 이름입니다.

계정의 성장 추이는 어떻게 추적하나요?

일정에 따라 주기적으로 호출하고 follower_count, following_count, post_count를 호출 날짜와 함께 user_id를 키로 저장하세요. 호출 한 번이 스냅샷 하나이므로 시계열의 세밀함은 호출 주기에 달려 있습니다. null 값은 0으로 떨어진 것이 아니라 데이터 공백을 나타냅니다.

계정의 게시물과 팔로워는 어떻게 가져오나요?

이 기능은 프로필만 반환합니다. 계정의 게시물은 같은 핸들을 X (Twitter) Posts by user에 넘겨 가져오고, 팔로우 관계 양쪽의 계정은 Follower list와 Following list에 넘겨 가져오세요. 세 기능 모두 같은 형식의 username을 받습니다.

오류 및 과금

401: 키가 없거나 유효하지 않습니다.
402: 잔액이 부족합니다. 먼저 충전하세요.
422: 파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
429: 분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
503: 처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
200 빈 결과: 데이터가 없습니다. 과금되지 않습니다.

오류

공식 참고 자료

객체와 용어를 확인하는 용도로만 사용합니다. 해당 플랫폼이 EveryInfra를 승인하거나 보증한다는 의미는 아닙니다.

X: username / handle과 표시 이름의 차이 ↗
X는 핸들과 표시 이름을 구분합니다. 핸들은 @ 식별자와 프로필 링크를 구성하며, 핸들을 변경하면 기존 핸들을 다른 사용자가 가져갈 수 있습니다. 아카이빙할 때는 표시 이름이나 변경 가능한 핸들에만 의존해 신원을 확인하지 마십시오.
2026-09-04 확인