100 크레딧 무료, 카드 등록 없이
Facebook Profile Posts API
API 한 번의 호출로 Facebook Profile Posts 데이터를 받아 가세요. Returns a list of recent posts from a Facebook page or profile. Each post includes the post text, like count, comment count, media attachments, the publish timestamp, and the per-reaction breakdown on `post.ext.reaction_counts` (`[{type, count}]`, highest first). Facebook publishes a post's share count, and a reel's exact view count and duration, on the individual post only, not on the feed, so on a plain call `post.engagement.shares` is null on every row and `post.engagement.views` and `post.content.duration_seconds` are null on reels. Send `include=engagement` and every row is joined, in the same call, to the per-post lookup that carries them: the share count lands on each row, and the exact view count and duration on each reel. The reaction counts and the publish time the feed already carries are never replaced, and a row that links to an event rather than a post is not looked up. Cost: 1 credit for the page plus 1 credit per row filled from a fresh lookup (3 rows a page, so 4 credits at most); rows already in cache are filled for free, rows that could not be filled are refunded, and a repeat of the same call within the cache window is 0 credits. Time: `include=engagement` adds 2 to 7 seconds on a fresh page (the lookups run in parallel and the call waits for the slowest, never more than 12 seconds) and nothing when the rows are already cached. The response carries a `hydration` block itemising rows, lookups, cache hits, credits and milliseconds. Facebook serves this feed in small slices, so the first response is a window onto the page rather than everything it has: `pagination.page_size` reports how many posts that window held, and 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 (plus the join when you ask for it), so depth is bounded by how many pages you buy. `recent_days=N` keeps only posts from the last N days and ends the walk once a page reaches older posts; it does not change the price of a page.
2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요
Facebook 페이지나 프로필의 최근 게시물을 돌려줍니다. 글 내용과 좋아요 수, 댓글 수, 반응 종류별 집계, 첨부 미디어, 게시 시각이 함께 나옵니다. 그냥 부르면 공유 수는 비어 있습니다.
url이나 pageId로 한 페이지의 최근 콘텐츠를 훑을 때 사용하세요. include=engagement를 붙이면 같은 호출에서 모든 줄에 공유 수가 채워지고 릴스에는 정확한 조회수와 재생 시간까지 채워집니다.
68개 플랫폼을 병렬로 검색합니다
·
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·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
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·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·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·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·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·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·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·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·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·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·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·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·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·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchFacebook API
Profile Posts API로 무엇을 할 수 있을까요
Profile Posts 엔드포인트가 통합 스키마와 계산 필드를 담은 Facebook 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/facebook/profile/posts?since=2026-09-01&url=https%3A%2F%2Fwww.facebook.com%2FMeta"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/facebook/profile/posts",
params={
'since': '2026-09-01',
'url': 'https://www.facebook.com/Meta',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/facebook/profile/posts?since=2026-09-01&url=https%3A%2F%2Fwww.facebook.com%2FMeta",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();함께 보내면 좋은 파라미터
since=2026-09-01이 날짜 이후에 올라온 게시물만 반환합니다. 매일 조회할 때 새 게시물이 있는 페이지만 과금됩니다.
파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| since | 아니오 | Only posts published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Older posts are left off the page, and the page that reaches one ends the walk: `next_cursor` is not returned and `pagination.stopped_at` is `since`. Pinned posts sit out of date order and never end the walk. The page still costs what a page costs, so a daily poll pays for the pages it walks and no more. |
| stop_at_id | 아니오 | The id (`post.id`) or URL (`post.url`) of the newest post you already hold. The page stops just before it: that post and everything after it are left off, `next_cursor` is not returned, and `pagination.stopped_at` is `known_id`. A pinned post never counts as the stop point. If it is not on this page the page is returned in full with its cursor, so keep walking. `pagination.stopped_at` is `end` when the list ran out first and `null` while there is more to walk. |
| url | 아니오 | Full URL of the Facebook page or profile to fetch posts for |
| pageId | 아니오 | Facebook profile page id |
| cursor | 아니오 | To paginate through the posts |
| include | 아니오 | Set to `engagement` (one token only) to fill `post.engagement.shares` on every row, and `post.engagement.views` and `post.content.duration_seconds` on reels, in this one call. Holds 1 credit per row (3 a page) and keeps only the rows filled from a fresh lookup: rows already in cache and rows the lookup cannot fill are refunded, and a row with no public share count stays null and is free, so a page is never more than 4 credits and the usual bill is lower. A row that links to an event rather than a post is not looked up. The join takes 2 to 7 seconds on a fresh page, never more than 12, and nothing when the rows are already cached; read `data.hydration` for the rows, the credits held and kept, and the time. Without it the call is unchanged. (engagement) |
| recent_days | 아니오 | Keep only posts published in the last N days (1 to 3650) and stop pagination once a page reaches older posts. Does not change the price of a page. |
| until | 아니오 | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |
응답 예시
Facebook Profile Posts API는 무엇을 돌려주나요
모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.
응답 예시 보기
{
"success": true,
"platform": "facebook",
"endpoint": "/v1/facebook/profile/posts",
"data": {
"items": [
{
"post": {
"id": "1152729184082957",
"url": "https://www.facebook.com/reel/2277713513083702/",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": "https://scontent-lga3-1.xx.fbcdn.net/v/t15.5256-10/832662077_1745304503394391_8093661530441784354_n.jpg?stp=dst-jpg_p565x565_tt6&_nc_cat=103&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=NDpCrzBK770Q7kNvwGyaeJt&_nc_oc=AdrlDwjddcMXqYC3gX6XsTrZH9z3JR3ee1h_h5iPdUL9ECVaeUwmhJJEmPO0gopqyhg&_nc_zt=23&_nc_ht=scontent-lga3-1.xx&_nc_gid=MjqYFXS4EsUT7fF7gV3ocQ&_nc_ss=78289&oh=00_AQMiv1syHdc2xvm30zds_d5trO179vjqkC_6qS9P7TLoXQ&oe=6AC5130A",
"thumbnail_url": "https://scontent-lga3-1.xx.fbcdn.net/v/t15.5256-10/832662077_1745304503394391_8093661530441784354_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=be8305&_nc_ohc=NDpCrzBK770Q7kNvwGyaeJt&_nc_oc=AdrlDwjddcMXqYC3gX6XsTrZH9z3JR3ee1h_h5iPdUL9ECVaeUwmhJJEmPO0gopqyhg&_nc_zt=23&_nc_ht=scontent-lga3-1.xx&_nc_gid=MjqYFXS4EsUT7fF7gV3ocQ&_nc_ss=78289&oh=00_AQPNf5IOq8IR_YiMnPpsA9ilDVJU5hDGRMgC8AQY_Fvxkw&oe=6AC5130A",
"duration_seconds": null
},
"author": {
"username": null,
"display_name": "Meta",
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": 666,
"comments": 191,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-10-01T16:17:21.000Z",
"ext": {
"author_id": "user_9cf871",
"published_at_epoch": 1790871441,
"reaction_counts": [
{
"type": "like",
"count": 561
},
{
"type": "love",
"count": 84
}
],
"feedback_id": "ZmVlZGJhY2s6MTE1MjcyOTE4NDA4Mjk1Nw=="
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null,
"vs_creator": {
"ratio": null,
"metric": "likes",
"reason": "too_young"
}
}
},
{
"post": {
"id": "1151655277523681",
"url": "https://www.facebook.com/reel/1737837581070505/",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": "https://scontent-lga3-3.xx.fbcdn.net/v/t15.5256-10/830096675_1581575039848247_6418634667320817606_n.jpg?stp=dst-jpg_p552x414_tt6&_nc_cat=102&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=MikVnzHxCtMQ7kNvwF5Wlzv&_nc_oc=AdqFvEv4rM_9wvNx35Lpz6NrivM-TGsYbrkNRtbfR0sqmcqj0k2uHr_jD_K27NQ0mbI&_nc_zt=23&_nc_ht=scontent-lga3-3.xx&_nc_gid=MjqYFXS4EsUT7fF7gV3ocQ&_nc_ss=78289&oh=00_AQMvH1vCUl5wxaWGOy1DLqCVaqxlAyQdmnWgHKimeTEZYw&oe=6AC51880",
"thumbnail_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t15.5256-10/830096675_1581575039848247_6418634667320817606_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=MikVnzHxCtMQ7kNvwF5Wlzv&_nc_oc=AdqFvEv4rM_9wvNx35Lpz6NrivM-TGsYbrkNRtbfR0sqmcqj0k2uHr_jD_K27NQ0mbI&_nc_zt=23&_nc_ht=scontent-lga3-3.xx&_nc_gid=MjqYFXS4EsUT7fF7gV3ocQ&_nc_ss=78289&oh=00_AQNeX4q0KidhNnAqjLmZVk25rM9Md0o126DMcN9etb7BEA&oe=6AC51880",
"duration_seconds": null
},
"author": {
"username": null,
"display_name": "Meta",
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": 2199,
"comments": 435,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-09-30T16:09:30.000Z",
"ext": {
"author_id": "user_9cf871",
"published_at_epoch": 1790784570,
"reaction_counts": [
{
"type": "like",
"count": 1854
},
{
"type": "love",
"count": 257
}
],
"feedback_id": "ZmVlZGJhY2s6MTE1MTY1NTI3NzUyMzY4MQ=="
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null,
"vs_creator": {
"ratio": null,
"metric": "likes",
"reason": "too_young"
}
}
}
],
"next_cursor": "sc2.eyJzIjoiYiIsImMiOiJDZzhPYjNKbllXNXBZMTlqZFhKemIzSUpBQUFDbWtGUlNGUm9iWGMyTXkxR1MyazJiV0Z4TWtNdFJFOVpNbXRZU25SZmFHVkJVVjlhYUVnd2FVVm5aMDEyVmpCcldXYzBialpxWjBrMlFVaFFRV0ZvZVVoNmRUWlNaVlY1Ykc1Qk0yMUphR3BHUW1sMFdGQTBRMDl3TW1wemIxUXhRbWhuUTBwR1lXbG5kM0pzWHpneE0wNXRjVlJQY3pGNlFUWlZXRzVUUkV0V2FGcFljMmgyVVVremNEWm1RVWhIU0VWV1VtTk1iMVJCWVUxMlVHNXpiVVpEVkRCVFpqRjNUMWhmY0dWd2JGSXlUbkJhWm5acmFGUm5jekV6V0ZOM1NIY3paR1ZTWTBKNFpHRnRWbWRaVVZSbmJXbHZTWFU0WjAxa1VVdHVhMGh4UTBKdFlXeEtaazVqYjI5MmRrb3RlVTlZWTNKdWNqbFVVa0ZyTlhoWFpIcG1TSFJIYzBwM1l6WkJXVVpaYkRaTGEyTkdlbTFvTkhwUU5rNXZOSFI0U0cxbWNHMXFSRTl4UXpCeGVGcEpablJmYzBOS2VWTXhkMTkxUlY5U05Gb3plamgwUkZJNVpVNHdVa2xVYW1GWlNtMWpNR2N5TUc5R01GVXRja3hxVkdGa1J6ZGZSMmQyVWpCMFluSlhkMVpzTmxRMVJGWnlURTFEY0hKRVYybDJkV05NWTB0NFExRk9TbGwzWmt4ek5VWjVlSGhYUVhkSmEzbG5PWEZ0Tm5sNlJrbzNia0pLTlZkSWNsWjRNVWh6YUc1RlRUUkxRazA1WkhsVU4wdHRaV1pLTUZvMVJXdGZTMTl2UVhoR1prRkJWa3RTVDB0cVoyUmZkREZLU0c5YWMwd3daWGRoYldzeFpUUkVVRGR3YlRWSlVXSjJObGc0U0hJNWNISkRaMDFNYUVGWVUxcDVlalJUYUhGQlpFUm5TREphUkVKRVJrVm9UWGhaTmpGb1FtNWxXRkJ2U2tkclpEaDNkSHBKY1RoVFNHbHNUWGx0U1RSU05rRjBjSEJzV0VWUmRVTlZZV2g1WlVkQmVGcEhNREY2YmxFNFRraEZjbVZPY3pKV2FXTjRaRGxaV21oV01TMTZjamMwVGxSSU5rWTJaV053VjNCSmJuSXhNelJtYzNSb05XVkdaelF5WjBOVGRGRXpWbW94WmxOQ2RFdEhWRmcyWnc4SllXUmZZM1Z5YzI5eURnOFBaMnh2WW1Gc1gzQnZjMmwwYVc5dUFnQVBCbTltWm5ObGRBSUFEeEJzWVhOMFgyRmtYM0J2YzJsMGFXOXVBdjhCIn0",
"total": null,
"creator_baseline": {
"baseline": null,
"reason": "fewer_than_eight",
"rows_used": 1,
"cadence": "measured"
},
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoic2MyLmV5SnpJam9pWWlJc0ltTWlPaUpEWnpoUFlqTktibGxYTlhCWk1UbHFaRmhLZW1JelNVcEJRVUZEYld0R1VsTkdVbTlpV0dNeVRYa3hSMU15YXpKaVYwWjRUV3ROZEZKRk9WcE5iWFJaVTI1U1ptRkhWa0pWVmpsaFlVVm5kMkZWVm01YU1ERXlWbXBDY2xkWFl6QmlhbHB4V2pCck1sRlZhRkZSVjBadlpWVm9ObVJVV2xOYVZsWTFZa2MxUWsweU1VcGhSM0JIVVcxc01GZEdRVEJSTURsM1RXMXdlbUl4VVhoUmJXaHVVVEJ3UjFsWGJHNWtNMHB6V0hwbmVFMHdOWFJqVmxKUVkzcEdObEZVV2xaWFJ6VlVVa1YwVjJGR2NGbGpNbWd5VlZWcmVtTkVXbTFSVldoSVUwVldWMVZ0VGsxaU1WSkNXVlV4TWxWSE5YcGlWVnBFVmtSQ1ZGcHFSak5VTVdobVkwZFdkMkpHU1hsVWJrSmhXbTVhY21GR1VtNWpla1Y2VjBaT00xTklZM3BhUjFaVFdUQktORnBIUm5SV2JXUmFWVlpTYm1KWGJIWlRXRlUwV2pBeGExVlZkSFZoTUdoNFVUQktkRmxYZUV0YWF6VnFZakk1TW1ScmIzUmxWVGxaV1ROS2RXTnFiRlZWYTBaeVRsaG9XRnBJY0cxVFNGSklZekJ3TTFsNldrSlhWVnBhWWtSYVRHRXlUa2RsYlRGdlRraHdVVTVyTlhaT1NGSTBVMGN4YldOSE1YRlNSVGw0VVhwQ2VHVkdjRXBhYmxKbVl6Qk9TMlZXVFhoa01Ua3hVbFk1VTA1R2IzcGxhbWd3VWtaSk5WcFZOSGRWYTJ4VllXMUdXbE50TVdwTlIyTjVUVWM1UjAxR1ZYUmphM2h4VmtkR2ExSjZaR1pTTW1ReVZXcENNRmx1U2xoa01WcHpUbXhSTVZKR1dubFVSVEZFWTBoS1JWWXliREprVjA1TldUQjBORkV4Ums5VGJHd3pXbXQ0ZWs1VldqVmxTR2hZVVZoa1NtRXpiRzVQV0VaMFRtNXNObEpyYnpOaWEwcExUbFprU1dOc1dqUk5WV2g2WVVjMVJsUlVVa3hSYXpBMVdraHNWVTR3ZEhSYVYxcExUVVp2TVZKWGRHWlRNVGwyVVZob1IxcHJSa0pXYTNSVFZEQjBjVm95VW1aa1JFWkxVMGM1WVdNd2QzZGFXR1JvWWxkemVGcFVVa1ZWUkdSM1lsUldTbFZYU2pKT2JHYzBVMGhKTldOSVNrUmFNREZOWVVWR1dWVXhjRFZsYWxKVVlVaEdRbHBGVW01VFJFcGhVa1ZLUlZKclZtOVVXR2hhVG1wR2IxRnROV3hYUmtKMlUydGtjbHBFYUROa1NIQktZMVJvVkZOSGJITlVXR3gwVTFSU1UwNXJSakJqU0VKelYwVldVbVJWVGxaWlYyZzFXbFZrUW1WR2NFaE5SRVkyWW14Rk5GUnJhRVpqYlZaUFkzcEtWMkZYVGpSYVJHeGFWMjFvVjAxVE1UWmphbU13Vkd4U1NVNXJXVEphVjA1M1ZqTkNTbUp1U1hoTmVsSnRZek5TYjA1WFZrZGFlbEY1V2pCT1ZHUkdSWHBXYlc5NFdteE9RMlJGZEVoV1JtY3lXbmM0U2xsWFVtWlpNMVo1WXpJNWVVUm5PRkJhTW5oMldXMUdjMWd6UW5aak1td3dZVmM1ZFVGblFWQkNiVGx0V201T2JHUkJTVUZFZUVKeldWaE9NRmd5Um10WU0wSjJZekpzTUdGWE9YVkJkamhDSW4wIiwiZSI6ImZhY2Vib29rL3Byb2ZpbGUvcG9zdHMiLCJwIjoiY3Vyc29yIn0",
"has_more": true,
"page_size": 3,
"stopped_at": null
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T07:25:29.029Z",
"redacted": true
}통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.
API 상세
Facebook Profile Posts API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
개발자 우선
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 68개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 68개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 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"
}
}
}자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기Facebook 페이지의 게시물 목록은 어떻게 가져오나요?
GET /v1/facebook/profile/posts에 url 또는 pageId를 담아 호출하면 돼요. 본문, 좋아요 수, 댓글 수, 리액션 분포, 첨부 미디어, 작성 시각까지 최근 게시물 배열을 JSON으로 받아볼 수 있어요. include=engagement를 함께 보내면 같은 호출에서 공유 수까지 행마다 채워져서 와요.
각 게시물에는 어떤 필드가 포함되나요?
게시물마다 id, 본문, 좋아요 수, 댓글 수, 작성 시각, 작성자 정보, 이미지·영상·링크 등 첨부 미디어가 함께 들어와요. 공유 수는 Facebook이 피드가 아니라 게시물 자체에만 실어서, include=engagement로 요청하면 post.engagement.shares가 행마다 채워져요. 모든 SocialCrawl 플랫폼이 같은 필드명을 써서 개발이 쉽고 간편해요.
이전 게시물은 어떻게 페이지네이션하나요?
응답에 포함된 cursor 값을 다음 요청의 cursor 파라미터로 그대로 전달하면 돼요. 빈 cursor가 올 때까지 반복하면 Graph API의 페이지네이션 제약 없이 수백 개의 게시물을 이어서 받아볼 수 있어요.
URL 대신 pageId를 써도 되나요?
네, url 또는 pageId 중 아무거나 전달하면 돼요. 이미 Facebook 페이지 ID를 보유하고 계시다면 pageId로 호출하는 편이 URL을 다시 해석하는 과정보다 조금 더 빠르게 응답을 받아볼 수 있어요.
영상 게시물이나 릴스도 응답에 포함되나요?
네, 영상과 릴스 게시물도 미디어 URL과 함께 들어와요. 릴스의 정확한 조회수와 재생 시간은 피드가 아니라 릴스 자체에 있어서, include=engagement로 요청하면 릴스 행마다 둘 다 채워져요. 릴스만 따로 받고 싶다면 /v1/facebook/profile/reels, 사진만 받고 싶다면 /v1/facebook/profile/photos를 쓰시면 돼요.
include=engagement는 요금과 응답 시간이 어떻게 되나요?
페이지가 1 크레딧이고, 새로 조회해서 채운 행마다 1 크레딧이 더해져서 한 페이지는 최대 4 크레딧이에요. 이미 캐시에 있는 행은 무료로 채워지고, 채우지 못한 행은 환불돼요. 새 페이지 기준으로 2~7초가 더 걸리고 캐시된 행은 추가 시간이 없어요. 행 수와 크레딧, 소요 시간은 data.hydration에서 확인하실 수 있어요.
AI에게 SocialCrawl을 물어보세요
Facebook Profile Posts 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Facebook 데이터를 받아 가세요.