x/
profiles

하나 이상의 공개 X 사용자 이름을 계정 정보, 소개글, 이미지, 계정 상태, 공개된 오디언스 수치, 수집 시각이 담긴 프로필 레코드로 조회합니다.

Twitter Profile Scraper API

프로필 정보
오디언스 수치
계정 스냅샷
결과당 0.6 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Twitter Profile Scraper

X 프로필은 사용자 이름, 표시 이름, 소개글, 프로필 URL, 이미지, 상태 표시, 공개된 수치로 공개 계정을 식별합니다. 수집 시점이 명확한 상태에서 이런 신호를 함께 보면 계정 선별, 디렉터리 정보 보강, 프로필 변경 비교에 도움이 됩니다.

Twitter Profile Scraper API 주요 기능

  • 사용자 이름으로 프로필 조회각 값에 맨 앞의 @가 있든 없든, 공개 X 사용자 이름을 하나 이상 한 번의 수집으로 조회합니다.
  • 계정 정보, 소개글, 이미지ID, 사용자 이름, 표시 이름, 프로필 URL, 소개글, 위치, 아바타, 커버, 생성 시각으로 계정 레코드를 구성합니다.
  • 계정 상태와 오디언스 규모인증, 비공개, 메시지, 고정 게시물, 자동화 신호를 팔로워·팔로잉·게시물·미디어·좋아요 수와 함께 제공합니다.
  • 비교 가능한 프로필 스냅샷제출한 사용자 이름, 계정 생성일, collected_at을 함께 보관해 반복 조회한 결과를 시간순으로 추적할 수 있습니다.

Twitter Profile Scraper API 매개변수

매개변수필수설명
usernames필수공개 X 사용자 이름의 목록으로, 필수 값입니다. 각 값의 맨 앞 @는 있어도 없어도 됩니다.

Twitter Profile Scraper API 사용 방법

계정 목록을 먼저 준비한 뒤, 공용 비동기 작업과 커서 결과 흐름으로 조회합니다.

  1. 확인할 공개 사용자 이름을 정리합니다. 맨 앞의 @는 선택 사항입니다.
  2. usernames 배열을 /v1/x/profiles로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 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 true

Twitter Profile Scraper API 추천 활용 사례

  • 크리에이터·파트너 계정 검증: 알고 있는 목록에서 계정 정보, 소개글, 인증 상태, 오디언스 수치를 비교한 뒤 최종 후보 목록에 추가합니다.
  • 계정 디렉터리 보완: 기존 CRM이나 파트너 레코드에 프로필 URL, 표시 이름, 소개글, 이미지, 위치, 공개 수치를 추가합니다.
  • 프로필 변경 비교: 같은 계정 ID를 반복 조회하고 collected_at을 기준으로 스냅샷 사이의 소개글, 상태 신호, 오디언스 수치를 비교합니다.

Twitter Profile Scraper API 활용 팁

  • 계정 목록이 많다면 제출 전에 맨 앞의 @를 제거하고 대소문자 구분 없이 사용자 이름의 중복을 정리하세요.
  • id를 안정적인 계정 키로 저장하고, 표시와 출처 매칭용으로 username과 extra.input_username도 함께 보관하세요.
  • 팔로워·게시물·미디어 수는 고정된 값이 아니므로, 비교할 때마다 collected_at을 기준으로 삼으세요.
  • 일부만 공개된 프로필 때문에 후속 레코드가 깨지지 않도록, 선택 이미지와 계정 신호는 null을 허용하세요.

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 게시물을 최고 화질 미디어 파일과 함께 수집합니다.

다른 플랫폼 둘러보기

X 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Twitter Profile Scraper API — 자주 묻는 질문

Twitter Profile Scraper API는 하나 이상의 사용자 이름에 대한 공개 X 프로필 레코드를 가져옵니다. 계정 정보, 소개글, 이미지, 상태 신호, 공개된 오디언스 수치, 수집 시각을 반환합니다.

usernames 배열에 공개 핸들을 하나 이상 제출합니다. nasa와 @nasa 모두 사용할 수 있으며, 중복된 값은 수집 전에 정규화됩니다.

레코드에는 계정 ID, 사용자 이름, 표시 이름, 프로필 URL, 소개글, 위치, 아바타, 커버, 계정 상태, 생성 시각, 공개 수치가 포함될 수 있습니다.

collected_at 시점에 확인한 공개 값으로 보세요. 시간에 따른 변화를 비교하려면 같은 id에 대한 반복 레코드를 저장해 두세요.

수집 시점에 사용자 이름이 유효하고 공개적으로 접근 가능해야 결과가 나옵니다. 이름이 바뀌었거나 비공개, 정지, 제한, 사용 불가 상태인 계정은 사용할 수 있는 레코드가 없을 수 있습니다.

반환된 정규화 프로필 결과 하나당 0.6 SocQ 크레딧이 차감됩니다.