Facebook API: 프로필 — 사용자 ID별 게시물

이 엔드포인트가 하는 일

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

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

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

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

적합한 사용 시점

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

주요 사용 사례

레코드 보강

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

데이터 검증

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

분석 준비

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

사용 가능한 버전

응답 버전

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

응답 버전 V2

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

V1 사용 불가

동일하게 유지되는 것

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

버전 간에 달라지는 것

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

사용 방법

메서드 호출 방법

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

입력 매개변수

공통 매개변수

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

버전별 요청 경로

V2

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

GET /api/v2/facebook.com/profile/posts-by-user-id

정규화된 형식

요청 미리보기

기본 URL https://www.scrapestorm.net

엔드포인트 /api/v2/facebook.com/profile/posts-by-user-id

필수 매개변수

user_id

선택 매개변수

cursor

예시 URL

https://www.scrapestorm.net/api/v2/facebook.com/profile/posts-by-user-id?user_id=4

코드 예제

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/facebook.com/profile/posts-by-user-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_id=4' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/facebook.com/profile/posts-by-user-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "user_id": "4",
}

# Optional parameters
# params["cursor"] = "cursor-next-page"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/facebook.com/profile/posts-by-user-id";

const params = new URLSearchParams({
  user_id: "4",
});

// Optional parameters
// params.set("cursor", "cursor-next-page");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  user_id: "4",
};

// Optional parameters
// params.cursor = "cursor-next-page";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "user_id" => "4",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";

try {
    $response = $client->request("GET", "/api/v2/facebook.com/profile/posts-by-user-id", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/facebook.com/profile/posts-by-user-id"

    params := url.Values{}
    params.Set("user_id", "4")

    // Optional parameters
    // params.Set("cursor", "cursor-next-page")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

응답 예시

버전별 실제 응답

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

응답 예시

V2 응답 JSON

검증된 예시

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

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": null,
    "has_more": false
  },
  "search_context": {
    "user_id": "100044234596005"
  },
  "data": {
    "profile": {
      "user_id": "100044234596005",
      "username": "DwayneJohnson",
      "display_name": "Dwayne The Rock Johnson",
      "alternate_name": null,
      "profile_url": "https://www.facebook.com/DwayneJohnson",
      "verified": true,
      "gender": "male",
      "category": "Public figure",
      "description": "Dwayne The Rock Johnson. 66,022,044 likes · 745,861 talking about this. The official Facebook page for Dwayne \"The Rock\" Johnson.",
      "external_links": [
        {
          "url": "https://therock.komi.io",
          "label": "therock.komi.io",
          "link_type": "website"
        }
      ],
      "emails": [],
      "phone_numbers": [],
      "followers_count": 66000000,
      "following_count": 23,
      "likes_count": 66022044,
      "talking_about_count": 745861,
      "avatar_url": "https://example.com/image.jpg",
      "banner_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.99422-6/738511563_2287489735394419_846629203386166573_n.png?stp=dst-png&cstp=mx2048x1152&ctp=s960x960&_nc_cat=105&ccb=1-7&_nc_sid=cc71…"
    },
    "posts": {
      "count": 9,
      "items": [
        {
          "url": "https://www.facebook.com/1501519391332533",
          "created_at": "2026-03-23T15:59:15Z",
          "post_id": "1501519391332533",
          "story_id": "1501519391332533",
          "feedback_id": null,
          "text": "The ocean chose her for a reason 🌊 Experience Disney’s MOANA only in thea ...",
          "hashtags": [],
          "emails": [],
          "author": {
            "url": "https://www.facebook.com/DwayneJohnson/",
            "user_id": "100044234596005",
            "username": "DwayneJohnson",
            "display_name": "Dwayne The Rock Johnson"
          },
          "reaction_count": 316000,
          "comment_count": 9000,
          "share_count": 36000,
          "video_view_count": null,
          "video_play_count": null,
          "attachments": [
            {
              "attachment_type": "VideoAttachment",
              "title": null,
              "url": "https://www.facebook.com/watch/?v=944805244845499",
              "media_url": null
            },
            {
              "attachment_type": "ImageAttachment",
              "title": null,
              "url": null,
              "media_url": "https://scontent-ams2-1.xx.fbcdn.net/v/t39.30808-6/741662427_1592394128911725_3434118842603641092_n.png?stp=c0.5000x0.5000f_dst-png_e15_p1170x400_q65_tt1_u&efg=eyJ1cmxnZW4iOiJ1cmxnZW5fZnJvbV91cmwifQ&_nc_cid=0&_nc_ad=z-m&_nc_rml=0&_nc_ht=scontent-ams2-1.xx&_nc_cat=109&_nc_ohc=A52zOQLPD7MQ7kNvwFs77g1&_nc_gid=r23BSeWR1BtWlWYm0_48dA&ccb=1-7&_nc_sid=08ce88&oh=00_AQALZ25PTNU8l2nUTpwp4wK9SWfsxb9hChO7yPKeqhKbWw&oe=6A632F14"
            },
            {
              "_more_items": 2
            }
          ],
          "media_count": 4,
          "media_types": [
            "video",
            "image"
          ],
          "external_link_url": null,
          "comments_preview": [
            {
              "text": "the wig deserves a credit",
              "reaction_count": 614,
              "published_time": "16 weeks ago"
            }
          ],
          "commenting_disabled": null,
          "cursor": null,
          "thumbnail_url": "https://example.com/image.jpg"
        },
        {
          "url": "https://www.facebook.com/reel/26802119992796665/",
          "created_at": "2026-07-19T18:11:09Z",
          "post_id": "1601278088023329",
          "story_id": "UzpfSTEwMDA0NDIzNDU5NjAwNToxNjAxMjc4MDg4MDIzMzI5OjE2MDEyNzgwODgwMjMzMjk=",
          "feedback_id": "ZmVlZGJhY2s6MTYwMTI3ODA4ODAyMzMyOQ==",
          "text": "Just landed in Tokyo 🛬 🇯🇵 \n130am, closing this gym out. Whenever I land in other countries/multiple time zones - I immediately hit the gym regardless of the time. Training is a…",
          "hashtags": [],
          "emails": [],
          "author": {
            "url": "https://www.facebook.com/DwayneJohnson",
            "user_id": "100044234596005",
            "username": null,
            "display_name": "Dwayne The Rock Johnson"
          },
          "reaction_count": 4003,
          "comment_count": 372,
          "share_count": 80,
          "video_view_count": 34215,
          "video_play_count": 96386,
          "attachments": [
            {
              "attachment_type": null,
              "title": null,
              "url": "https://www.facebook.com/reel/26802119992796665/",
              "media_url": "https://scontent-arn2-1.xx.fbcdn.net/v/t51.82787-10/750016152_18655768657000183_7127400850037911919_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=p296x100&_nc_cat=1&ccb=1-7&_nc_sid=5fad0e&_nc_aid=0&_nc_ohc=Fo55znelPAIQ7kNvwGgWL42&_nc_oc=AdppQeE_doRk3GX98f8Js-8efi85GkxVbHeNRUWzfz0rOg6Q6cUrNvywVCis022Dw8s&_nc_zt=23&_nc_ht=scontent-arn2-1.xx&_nc_gid=9op1vyLLkumZcWtgAWqKFw&_nc_ss=7c289&oh=00_AQBctsZc9mkekWEiR_0zqTgk2YHWzLwUcfVjjWiPdwAa-g&oe=6A632568"
            }
          ],
          "media_count": 1,
          "media_types": [
            "video"
          ],
          "external_link_url": null,
          "comments_preview": [
            {
              "text": "Always \"Cookin\" good🫡",
              "reaction_count": 5,
              "published_time": "3 hours ago"
            }
          ],
          "commenting_disabled": true,
          "cursor": null,
          "thumbnail_url": null
        },
        {
          "_more_items": 7
        }
      ]
    }
  }
}

프로필 작업 계속하기

관련 메서드는 같은 객체를 다른 식별자로 찾거나, 세부 정보를 열거나, 집계 보기로 전환합니다.

다음 단계

평가 계속하기

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

Facebook 플랫폼 페이지 열기

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

플랫폼 페이지 열기

API 메서드 요금 비교

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

요금 보기

연동 규칙 확인

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

문서 열기

자주 묻는 질문

팀이 구현 전에 묻는 질문

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

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

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

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

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

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

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