Twitter Profile Scraper
X 프로필은 사용자 이름, 표시 이름, 소개글, 프로필 URL, 이미지, 상태 표시, 공개된 수치로 공개 계정을 식별합니다. 수집 시점이 명확한 상태에서 이런 신호를 함께 보면 계정 선별, 디렉터리 정보 보강, 프로필 변경 비교에 도움이 됩니다.
Twitter Profile Scraper API 주요 기능
- 사용자 이름으로 프로필 조회각 값에 맨 앞의 @가 있든 없든, 공개 X 사용자 이름을 하나 이상 한 번의 수집으로 조회합니다.
- 계정 정보, 소개글, 이미지ID, 사용자 이름, 표시 이름, 프로필 URL, 소개글, 위치, 아바타, 커버, 생성 시각으로 계정 레코드를 구성합니다.
- 계정 상태와 오디언스 규모인증, 비공개, 메시지, 고정 게시물, 자동화 신호를 팔로워·팔로잉·게시물·미디어·좋아요 수와 함께 제공합니다.
- 비교 가능한 프로필 스냅샷제출한 사용자 이름, 계정 생성일, collected_at을 함께 보관해 반복 조회한 결과를 시간순으로 추적할 수 있습니다.
Twitter Profile Scraper API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | 공개 X 사용자 이름의 목록으로, 필수 값입니다. 각 값의 맨 앞 @는 있어도 없어도 됩니다. |
Twitter Profile Scraper API 사용 방법
계정 목록을 먼저 준비한 뒤, 공용 비동기 작업과 커서 결과 흐름으로 조회합니다.
- 확인할 공개 사용자 이름을 정리합니다. 맨 앞의 @는 선택 사항입니다.
- usernames 배열을 /v1/x/profiles로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 저장하고, has_more가 true인 동안 next_cursor를 사용합니다.
curl -X POST "https://api.socq.ai/v1/x/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@OpenAI"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTwitter Profile Scraper API 추천 활용 사례
- 크리에이터·파트너 계정 검증: 알고 있는 목록에서 계정 정보, 소개글, 인증 상태, 오디언스 수치를 비교한 뒤 최종 후보 목록에 추가합니다.
- 계정 디렉터리 보완: 기존 CRM이나 파트너 레코드에 프로필 URL, 표시 이름, 소개글, 이미지, 위치, 공개 수치를 추가합니다.
- 프로필 변경 비교: 같은 계정 ID를 반복 조회하고 collected_at을 기준으로 스냅샷 사이의 소개글, 상태 신호, 오디언스 수치를 비교합니다.
Twitter Profile Scraper API 활용 팁
- 계정 목록이 많다면 제출 전에 맨 앞의 @를 제거하고 대소문자 구분 없이 사용자 이름의 중복을 정리하세요.
- id를 안정적인 계정 키로 저장하고, 표시와 출처 매칭용으로 username과 extra.input_username도 함께 보관하세요.
- 팔로워·게시물·미디어 수는 고정된 값이 아니므로, 비교할 때마다 collected_at을 기준으로 삼으세요.
- 일부만 공개된 프로필 때문에 후속 레코드가 깨지지 않도록, 선택 이미지와 계정 신호는 null을 허용하세요.
관련 API
Twitter Profile Scraper API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
- X Followers List API — X 사용자 이름 하나 이상에 대해 공개 팔로워 계정 정보와 공개된 프로필 지표를 수집합니다.
- X Following List API — 공개 X 계정이 팔로우하는 프로필을 수집하며, 계정 정보, 소개글, 계정 신호, 공개된 카운터, 출처 사용자 이름을 포함합니다.
- X Post Retweeters API — 알고 있는 X 또는 Twitter 게시물 URL을 리포스트한 계정의 정규화된 공개 프로필을 작업 단위로 중복 없이 수집합니다.
- X Account Location API — 계정의 기반 국가, X 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.
- Twitter Media Scraper API — 계정이 올린 사진·동영상·GIF 게시물을 최고 화질 미디어 파일과 함께 수집합니다.
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API