X/Twitter API 문서

X/Twitter API: 프로필 — 사용자 ID별 게시물

객체 카드, 검증, 보강을 위해 알려진 식별자로 X/Twitter의 프로필 상세 공개 데이터를 가져오세요.

객체를 이미 알고 있고 제품에 현재 공개 컨텍스트가 필요할 때 "사용자 ID별 게시물"을 사용하세요.

메서드 GET
엔터티 프로필
버전 2
이 엔드포인트가 하는 일

이 API 메서드로 만들 수 있는 것

먼저 결과와 일반적인 워크플로를 확인한 다음 매개변수와 작동하는 요청 예제로 넘어가세요.

이 엔드포인트가 도움이 되는 일

응답은 사용 가능한 프로필 필드를 정규화된 V2 형식 또는 플랫폼 고유의 V1 형식으로 제공합니다.

적합한 사용 시점

객체를 이미 알고 있고 제품에 현재 공개 컨텍스트가 필요할 때 "사용자 ID별 게시물"을 사용하세요.

주요 사용 사례

레코드 보강

제품의 알려진 객체를 X/Twitter 공개 필드로 보완하세요.

데이터 검증

후속 처리 전에 식별자와 현재 공개 컨텍스트를 확인하세요.

분석 준비

객체 세부 정보를 보고서, 평가, 관련 요청의 입력으로 사용하세요.

사용 가능한 버전

응답 버전

두 버전 모두 같은 작업을 해결하며 같은 매개변수를 받습니다. 전환기로 응답 구조를 비교하고 클라이언트가 기대하는 버전을 선택하세요.

응답 버전 V2

이 페이지에서 버전을 전환하면 같은 문서 URL에서 응답 구조를 비교할 수 있습니다.

동일하게 유지되는 것

인증, 필수 매개변수, 요청 형태는 V1과 V2에서 같습니다. 실제로는 엔드포인트 경로를 구성할 때와 응답을 읽을 때 버전을 선택합니다.

버전 간에 달라지는 것

주요 차이는 응답 봉투입니다. 새 연동에는 V2를 사용하고, 기존 클라이언트 계약과의 호환성이 필요한 경우에만 V1을 유지하세요.

사용 방법

메서드 호출 방법

두 버전 모두 같은 API 키 헤더와 같은 쿼리 매개변수를 사용합니다. 이 문서는 먼저 공통 매개변수를 보여 준 다음 각 버전의 경로와 코드 스니펫을 보여 줍니다.

입력 매개변수

공통 매개변수
매개변수 필수 유형 예시 설명
user_id 예 str 44196397 선택한 플랫폼에서 사용자의 숫자 ID.
cursor 아니요 str | None DAABCgABF4ABCD... 이전 응답에서 받은 다음 페이지 커서. 첫 페이지에서는 생략합니다.

버전별 요청 경로

V2

정확한 엔드포인트 경로, 예시 URL, 코드 스니펫을 복사할 때 버전을 선택하세요. 위의 매개변수 목록은 바뀌지 않습니다.

GET /api/v2/twitter.com/profile/tweets-by-user-id

정규화된 형식

코드 예제

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/twitter.com/profile/tweets-by-user-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_id=44196397' \
  # Optional parameters:
  # --data-urlencode 'cursor=DAABCgABF4ABCD...'
응답 예시

버전별 실제 응답

미리보기에는 주요 필드와 컬렉션의 첫 항목이 포함되어 있어 응답 형태를 빠르게 확인할 수 있습니다. 버전을 바꾸면 JSON 형식이 바뀝니다.

응답 예시

V2 응답 JSON

검증된 예시

이 간결한 JSON 예시는 V2의 최근 성공한 검증 실행에서 가져왔습니다.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "user_id": "44196397"
  },
  "data": {
    "tweets": {
      "count": 20,
      "items": [
        {
          "url": "https://x.com/elonmusk/status/2078940289226482120",
          "tweet_id": "2078940289226482120",
          "text": "RT @PeterDiamandis: The first phone call across the Atlantic, in 1927, cost about seventy five dollars for three minutes, more than a thous…",
          "hashtags": [],
          "emails": [],
          "created_at": "2026-07-19T20:29:24Z",
          "language": "en",
          "source": "Twitter for iPhone",
          "author": {
            "url": "https://x.com/elonmusk",
            "user_id": "44196397",
            "username": "elonmusk",
            "display_name": "Elon Musk",
            "description": "Starmind",
            "emails": [],
            "external_links": [],
            "location": null,
            "created_at": "2009-06-02T20:12:29Z",
            "is_verified": false,
            "is_blue_verified": true,
            "is_protected": false,
            "possibly_sensitive": false,
            "default_profile": false,
            "default_profile_image": false,
            "followers_count": 240944556,
            "following_count": 1370,
            "tweet_count": 105744,
            "media_count": 4625,
            "listed_count": 170041,
            "like_count": 239681,
            "professional_type": "Creator",
            "professional_category_name": null,
            "affiliated_account": {
              "label": "X",
              "url": "https://x.com/X",
              "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
              "label_type": "BusinessLabel"
            },
            "_more_fields": "5 more fields"
          },
          "is_from_automated_account": null,
          "media": {
            "images": [],
            "videos": [],
            "gifs": []
          },
          "external_links": [],
          "user_mentions": [
            {
              "user_id": "14710129",
              "username": "PeterDiamandis",
              "display_name": "Peter H. Diamandis, MD",
              "start_index": 3,
              "end_index": 18
            }
          ],
          "is_reply": false,
          "reply": null,
          "is_quote": false,
          "quote_tweet_id": null,
          "is_retweet": true,
          "retweeted_tweet_id": "2078903115248460118",
          "reply_count": 0,
          "retweet_count": 296,
          "quote_count": 0,
          "like_count": 0,
          "bookmark_count": 0,
          "_more_fields": "3 more fields"
        },
        {
          "url": "https://x.com/elonmusk/status/2078939898870903135",
          "tweet_id": "2078939898870903135",
          "text": "RT @PeterDiamandis: SpaceX's newest satellites carry about 1,024 gigabits of bandwidth each. The generation before carried 96. That is a te…",
          "hashtags": [],
          "emails": [],
          "created_at": "2026-07-19T20:27:51Z",
          "language": "en",
          "source": "Twitter for iPhone",
          "author": {
            "url": "https://x.com/elonmusk",
            "user_id": "44196397",
            "username": "elonmusk",
            "display_name": "Elon Musk",
            "description": "Starmind",
            "emails": [],
            "external_links": [],
            "location": null,
            "created_at": "2009-06-02T20:12:29Z",
            "is_verified": false,
            "is_blue_verified": true,
            "is_protected": false,
            "possibly_sensitive": false,
            "default_profile": false,
            "default_profile_image": false,
            "followers_count": 240944556,
            "following_count": 1370,
            "tweet_count": 105744,
            "media_count": 4625,
            "listed_count": 170041,
            "like_count": 239681,
            "professional_type": "Creator",
            "professional_category_name": null,
            "affiliated_account": {
              "label": "X",
              "url": "https://x.com/X",
              "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
              "label_type": "BusinessLabel"
            },
            "_more_fields": "5 more fields"
          },
          "is_from_automated_account": null,
          "media": {
            "images": [],
            "videos": [],
            "gifs": []
          },
          "external_links": [],
          "user_mentions": [
            {
              "user_id": "14710129",
              "username": "PeterDiamandis",
              "display_name": "Peter H. Diamandis, MD",
              "start_index": 3,
              "end_index": 18
            }
          ],
          "is_reply": false,
          "reply": null,
          "is_quote": false,
          "quote_tweet_id": null,
          "is_retweet": true,
          "retweeted_tweet_id": "2078933283539148891",
          "reply_count": 0,
          "retweet_count": 233,
          "quote_count": 0,
          "like_count": 0,
          "bookmark_count": 0,
          "_more_fields": "3 more fields"
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}
다음 단계

평가 계속하기

이 문서를 첫 판단 기준으로 삼고, 반복 사용을 위해 엔드포인트를 연결하기 전에 요금, 플랫폼 지원 범위, 연동 규칙을 확인하세요.

X/Twitter 플랫폼 페이지 열기

구현 전에 관련 엔터티, API 메서드 그룹, 관련 문서를 비교하세요.

플랫폼 페이지 열기

API 메서드 요금 비교

사용량을 늘리기 전에 공개 요금표에서 이 메서드의 위치를 확인하세요.

요금 보기

연동 규칙 확인

시작 문서에서 인증, 버전, 재시도, 테스트와 운영의 차이를 확인하세요.

문서 열기
자주 묻는 질문

팀이 구현 전에 묻는 질문

이 답변을 참고하여 이 API 메서드가 워크플로, 버전 선택, 도입 계획에 맞는지 판단하세요.

이 X/Twitter API 메서드는 어떤 데이터를 반환하나요?

이 메서드는 프로필에 대해 "사용자 ID별 게시물"을 실행합니다. 아래의 간결한 응답 예시에서 필드의 정확한 구조를 확인할 수 있습니다.

V1과 V2 중 무엇을 선택해야 하나요?

새 연동에는 정규화된 구조를 제공하는 V2를 선택하세요. V1은 이미 플랫폼 고유 형식을 처리하는 클라이언트와의 호환성을 위해서만 사용하세요.

첫 요청에는 무엇이 필요한가요?

API 키를 만들어 요청 헤더에 넣고 표의 필수 매개변수를 입력하세요. 코드 예제에는 이미 올바른 경로와 요청 구조가 포함되어 있습니다.