100 크레딧 무료, 카드 등록 없이

X User Tweets API

Name: X User Tweets API
Brand: SocialCrawl
Availability: InStock

API 한 번의 호출로 X User Tweets 데이터를 받아 가세요. Returns the most recent tweets posted by a Twitter/X user in descending chronological order, each with the full text, like count, retweet count, reply count, bookmark count, view count, media attachments, and creation timestamp. Retweets and self-threaded replies are included, matching the account's Posts tab; a pinned tweet is flagged via `post.flags.pinned` and sorts by its own publish date. Page size is set by the source, typically around 20 tweets. Deeper history is a cursor walk: send `pagination.next_cursor` back as `cursor` and repeat until `pagination.has_more` is false; each page costs 1 credit.

2026년 8월 업데이트SocialCrawl 팀이 직접 관리해요

무료로 시작하기 문서 보기

계정의 최신 트윗을 최신순으로 돌려줍니다. 트윗마다 본문 전체, 좋아요와 리트윗, 답글과 북마크, 조회 수, 첨부 미디어, 작성 시각이 붙습니다. 한 번에 20개 안팎이 나옵니다.

타임라인을 읽을 때 사용하세요. 최신 글부터 내려오고 리트윗과 이어 쓴 스레드도 함께 나옵니다. 더 보려면 응답의 pagination.next_cursor를 cursor로 다시 보내면 다음 페이지가 나옵니다.

51개 플랫폼을 병렬로 검색합니다

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

X API

User Tweets API로 무엇을 할 수 있을까요

User Tweets 엔드포인트가 통합 스키마와 계산 필드를 담은 X 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/twitter/user/tweets?handle=elonmusk"

import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/twitter/user/tweets",
    params={
    'handle': 'elonmusk',
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()

const response = await fetch(
  "https://www.socialcrawl.dev/v1/twitter/user/tweets?handle=elonmusk",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

파라미터

파라미터	필수	설명
handle	예	Twitter username without the @ symbol
trim	아니오	Set to true for a trimmed down version of the response
cursor	아니오	To paginate through the tweets

응답 예시

X User Tweets API는 무엇을 돌려주나요

모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.

응답 예시 보기

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile/videos",
  "data": {
    "items": [
      {
        "post": {
          "id": "7658005300657638669",
          "url": "https://www.tiktok.com/@charlidamelio/video/7658005300657638669",
          "content": {
            "text": "dc @lara.joanna ",
            "media_urls": "https://v19.tiktokcdn-eu.com/4a08329b68e24d90b840a05c9244ba65/6a498c37/video/tos/alisg/tos-alisg-ve-37c799-sg/ocXRU4saOAVGYeJRAAygAjFIzOGsgRf4peSeXk/?a=1233&bti=MzU8OGYpNHYpNzo5ZjEuLjpkLTptNDQwOg%3D%3D&&bt=1135&ft=ERfCkaZWD00Q12Nvr-HxzIxRA7lGF3_45SY&mime_type=video_mp4&rc=OTg8NGkzZTQ8PDo1NmQ2O0BpanEzd205cmRlPDMzZzczNEAvNWM0NDFfNi8xMjExNF5eYSNmMGwyMmQ0LzBhLS1kMS9zcw%3D%3D&vvpl=1&l=20260703224143F66ABC3BD3A97DB0685C&btag=e000b0000",
            "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/owxEmiGPia440JkI3PgALU3bB7aBAlzdBEsKB~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=bf18ce44&x-expires=1783202400&x-signature=8AANrRWOCWfS6xtQ9JJiHB77vxo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",
            "duration_seconds": 16.903
          },
          "author": {
            "username": "charlidamelio",
            "display_name": "charli d’amelio",
            "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=e0b099bd&s=PUBLISH&sc=avatar&shcp=132edbea&shp=d05b14bd&t=223449c4&x-expires=1783202400&x-signature=9SsuimlpGdsdlerisiaqvDVLV3c%3D",
            "verified": true
          },
          "engagement": {
            "views": 3417578,
            "likes": 501973,
            "comments": 2618,
            "shares": 6304,
            "saves": 22989
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": false,
            "deleted": false
          },
          "published_at": "2026-07-02T18:51:58.000Z",
          "ext": {
            "music_id": "7656080164593437471",
            "published_at_epoch": 1783018318
          }
        },
        "computed": {
          "engagement_rate": 0.14949,
          "language": null,
          "content_category": "other",
          "estimated_reach": 4101094
        }
      },
      {
        "post": {
          "id": "7657606229484670221",
          "url": "https://www.tiktok.com/@charlidamelio/video/7657606229484670221",
          "content": {
            "text": "@Alexa Davis ",
            "media_urls": "https://v19.tiktokcdn-eu.com/07ada727f60ed77f8504c4c9aee6f992/6a498c31/video/tos/alisg/tos-alisg-ve-37c799-sg/oAmE41FRfIDnKlQAZjDgfcEsqFENRqYDSBGUSB/?a=1233&bti=MzU8OGYpNHYpNzo5ZjEuLjpkLTptNDQwOg%3D%3D&&bt=857&ft=ERfCkaZWD00Q12Nvr-HxzIxRA7lGF3_45SY&mime_type=video_mp4&rc=NWU8OTg2aTw6ODlpNDU1PEBpanlrNmw5cmxuPDMzZzczNEBfLTEtMy8tXzYxLzYvYTNfYSNlbGVvMmRrYC9hLS1kMS9zcw%3D%3D&vvpl=1&l=20260703224143F66ABC3BD3A97DB0685C&btag=e000b0000",
            "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/ooZRDflKEE2SIFSfsAqgFBcFEORUAY4jBDl2Yc~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=0ee7ce0e&x-expires=1783202400&x-signature=DiqCJ1sMgLvKp5k1aK2lKgBm7CU%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",
            "duration_seconds": 10.123
          },
          "author": {
            "username": "charlidamelio",
            "display_name": "charli d’amelio",
            "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=e0b099bd&s=PUBLISH&sc=avatar&shcp=132edbea&shp=d05b14bd&t=223449c4&x-expires=1783202400&x-signature=9SsuimlpGdsdlerisiaqvDVLV3c%3D",
            "verified": true
          },
          "engagement": {
            "views": 7205601,
            "likes": 739100,
            "comments": 1943,
            "shares": 6268,
            "saves": 28516
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": false,
            "deleted": false
          },
          "published_at": "2026-07-01T17:03:22.000Z",
          "ext": {
            "music_id": "7656080164593437471",
            "published_at_epoch": 1782925402
          }
        },
        "computed": {
          "engagement_rate": 0.103713,
          "language": null,
          "content_category": "other",
          "estimated_reach": 8646721
        }
      },
      {
        "post": {
          "id": "7657287641641143565",
          "url": "https://www.tiktok.com/@charlidamelio/video/7657287641641143565",
          "content": {
            "text": null,
            "media_urls": "https://v19.tiktokcdn-eu.com/24d5a0ceaf069ce4435f27d4a1fb7fa5/6a498c2d/video/tos/alisg/tos-alisg-ve-37c799-sg/o4IuEqzEKBC3UgRghYEA5FEDZJDB2RL2JfePpS/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&&bt=939&ft=ERfCkaZWD00Q12Nvr-HxzIxRA7lGF3_45SY&mime_type=video_mp4&rc=O2Q8M2k1Nzo7ODkzPGQ2NkBpM3VrZmo5cm01PDMzZzczNEBiYC0yLjU0XjQxNTMxX2FhYSNjZy5mMmRzYC9hLS1kMS9zcw%3D%3D&vvpl=1&l=20260703224143F66ABC3BD3A97DB0685C&btag=e000b0000",
            "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/oEEehFBRSDqxRYEZJgMgAQpzEf2PJiDEJNI7CB~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=7ef5f605&x-expires=1783202400&x-signature=10x4mFTkwGHZf2I3P%2FcRrZr6vTo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",
            "duration_seconds": 6.467
          },
          "author": {
            "username": "charlidamelio",
            "display_name": "charli d’amelio",
            "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=e0b099bd&s=PUBLISH&sc=avatar&shcp=132edbea&shp=d05b14bd&t=223449c4&x-expires=1783202400&x-signature=9SsuimlpGdsdlerisiaqvDVLV3c%3D",
            "verified": true
          },
          "engagement": {
            "views": 5941789,
            "likes": 941067,
            "comments": 3165,
            "shares": 17173,
            "saves": 18760
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": false,
            "deleted": false
          },
          "published_at": "2026-06-30T20:27:04.000Z",
          "ext": {
            "music_id": "7530783142774065975",
            "published_at_epoch": 1782851224
          }
        },
        "computed": {
          "engagement_rate": 0.161804,
          "language": null,
          "content_category": null,
          "estimated_reach": 7130147
        }
      }
    ],
    "next_cursor": "1782516110000",
    "total": 10,
    "dropped": 0
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req-8Kq2ZmR4vT9xLb3P",
  "cached": false,
  "pagination": {
    "next_cursor": "sc.eyJ2IjoyLCJjIjoiMTc4MjUxNjExMDAwMCIsInAiOiJtYXhfY3Vyc29yIn0",
    "has_more": true,
    "page_size": 10
  }
}

TikTok API에서 가져온 예시예요. 모든 SocialCrawl 엔드포인트가 똑같은 통합 스키마를 돌려주기 때문에, X User Tweets 응답도 같은 필드로 구성돼요.

API 상세

X User Tweets API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

X User Tweets 데이터는 왜 SocialCrawl로 가져올까요

X 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

모든 플랫폼이 같은 스키마라 연동은 한 번이면 끝이에요
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때 참여율·예상 도달·카테고리·언어 같은 계산 필드도 함께 와요
스크래핑 인프라도, 프록시도, 속도 제한도 신경 쓰지 않아도 돼요
X의 현재 공개 데이터를 돌려줘요. 엔드포인트별로 문서에 적힌 캐시 구간을 쓰고 적중하면 0크레딧이에요. Cache-Control: no-cache를 보내면 정상 요금으로 새로 조회해요

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 51개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 51개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.

코드 한 줄 쓰기 전에, 데이터부터

Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

+ 51개 플랫폼

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

사용자의 트윗 목록은 어떻게 받나요?

GET /v1/twitter/user/tweets에 handle(@ 없이)을 담아 호출하면 돼요. 사용자의 최근 트윗이 본문, 참여 지표, 미디어, 작성 시각과 함께 통합 스키마 배열로 바로 응답돼요.

트윗마다 어떤 필드가 담겨 오나요?

트윗 ID, 본문, 좋아요, 리트윗, 답글, 인용 수, 미디어(이미지·영상 URL), 언어 코드, 작성 시각, 리트윗·인용 여부 플래그까지 한 번에 받아볼 수 있어요. 리트윗과 원본 트윗도 구분돼 있어요.

응답을 가볍게 받아볼 수도 있나요?

네, trim=true 옵션을 함께 보내면 핵심 필드만 담긴 가벼운 응답으로 와요. 본문, ID, 참여 수만 필요한 대량 수집 작업에 쉽고 간편하게 쓸 수 있어요.

이 엔드포인트는 요금이 얼마인가요?

스탠다드 티어 기준 호출당 1 크레딧이에요. 새 계정은 100 크레딧이 무료로 들어가고, 월 최소 약정이나 구독 없이 쓴 만큼만 차감돼요. 레이트 리밋도 없어서 필요할 때 바로 호출할 수 있어요.

X API Pro 요금제가 꼭 있어야 하나요?

아니요. SocialCrawl은 공식 X API를 사용하지 않아서 Pro, Basic, Enterprise 모두 필요 없어요. x-api-key와 핸들만 보내면 개발자 포털 없이 공개 트윗 데이터를 바로 받아볼 수 있어요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

X API의 다른 엔드포인트

X의 모든 엔드포인트가 같은 통합 스키마를 돌려줘요.

Profile Tweet Community Community Tweets Tweet Transcript Ai Search

API 레퍼런스 X API 가이드 코드 튜토리얼

X User Tweets 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 X 데이터를 받아 가세요.

무료로 시작하기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요