> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a public Facebook profile's posts > Fetches a public Facebook profile/page's timeline posts (logged-out — only the posts visible in an incognito session). Pass `url` OR `pageId` (the numeric profile id — faster, it skips resolving the url). Each post includes text, author, media (photos/video), a shared-link preview, timestamp, and engagement stats (reactions with a per-type breakdown, comments, shares). Returns a `paging.cursor` / `paging.hasNextPage` for the next page. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/facebook/profile/posts openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: Google description: Google Search scraping endpoints paths: /v1/facebook/profile/posts: get: tags: - Facebook summary: Get a public Facebook profile's posts description: >- Fetches a public Facebook profile/page's timeline posts (logged-out — only the posts visible in an incognito session). Pass `url` OR `pageId` (the numeric profile id — faster, it skips resolving the url). Each post includes text, author, media (photos/video), a shared-link preview, timestamp, and engagement stats (reactions with a per-type breakdown, comments, shares). Returns a `paging.cursor` / `paging.hasNextPage` for the next page. parameters: - name: url in: query required: false description: >- **Required — provide one of `url` or `pageId`.** Public Facebook profile URL, e.g. https://www.facebook.com/Cristiano. schema: type: string example: https://www.facebook.com/Cristiano - name: pageId in: query required: false description: >- **Required — provide one of `url` or `pageId`.** Numeric profile id (faster than url). schema: type: string example: '100044296486382' - name: cursor in: query required: false description: The `paging.cursor` from a previous call, to fetch the next page. schema: type: string - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The profile posts. content: application/json: schema: type: object properties: data: type: object properties: posts: type: array items: type: object postCount: type: integer paging: type: object properties: cursor: type: string nullable: true hasNextPage: type: boolean fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: posts: - postId: '1741207314032468' storyId: >- UzpfSTEwMDA0NDI5NjQ4NjM4MjoxNzQxMjA3MzE0MDMyNDY4OjE3NDEyMDczMTQwMzI0Njg= url: >- https://www.facebook.com/Cristiano/posts/pfbid0fM2WgsGPx9o374EVYJZUb53K22GniewZGAucD8rs1zMFM4oixfzjdrMXss1188f8l text: We keep pushing. Together. 💪🟡🔵 author: name: Cristiano Ronaldo id: '100044296486382' url: https://www.facebook.com/Cristiano avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/724056214_1657518462401354_1550185043079196898_n.jpg?stp=c0.54.1366.1366a_cp0_dst-jpg_tt6&cstp=mx1366x1366&ctp=s40x40&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=a09PUl88X00Q7kNvwEHaN8A&_nc_oc=AdqCwiKuyFwo8qCPHlkHJuT-1etkgxJrgdYUmIioZ6KwOW1zQDDrIB8GfoV3i5ngppQ&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQI8J4OH-TWwxSgbeiZGgPM9-DVw5vT0L5oaXNbgjP9Ngw&oe=6AADC560 verified: null createdAt: '2026-09-13T09:53:19.000Z' createdTimestamp: 1789293199 media: type: photo videoId: null videoUrl: null videoHdUrl: null videoSdUrl: null thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/808322075_18772642810056421_8186953556932778401_n.jpg?stp=dst-jpg_tt6&cstp=mx2457x3072&ctp=s640x640&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=kZJeAc46Ju4Q7kNvwHkk7HA&_nc_oc=Ado4KSTkr7MXa0mD2xkvqml5eaUgLaUe_QfyBReRtqnouq7mIq-upNVVNVyfJYm2x4Q&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQKhqAwRCeatmkFDiadO8dcrnXO6v2wCmia23vsiZiUQCQ&oe=6AADBA8E width: null height: null durationSeconds: null images: - >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/808322075_18772642810056421_8186953556932778401_n.jpg?stp=dst-jpg_tt6&cstp=mx2457x3072&ctp=s640x640&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=kZJeAc46Ju4Q7kNvwHkk7HA&_nc_oc=Ado4KSTkr7MXa0mD2xkvqml5eaUgLaUe_QfyBReRtqnouq7mIq-upNVVNVyfJYm2x4Q&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQKhqAwRCeatmkFDiadO8dcrnXO6v2wCmia23vsiZiUQCQ&oe=6AADBA8E music: null link: null stats: reactions: 242870 reactionsByType: - type: Like count: 181891 - type: Love count: 51986 - type: Care count: 8021 comments: 5878 shares: 739 views: null viewsLabel: null topComments: - id: >- Y29tbWVudDoxNzQxMjA3MzE0MDMyNDY4XzE3MTc5NjExNTU5NDEyNDA= text: |- If RONALDO has a million fans, then I'm one of them. If RONALDO has 5 fans, then I'm one of them. If RONALDO has one fan, then I'm that one. If RONALDO has no fans, That means I'm dead. 😭😭 If the world is against CR7, then I'm against the world. author: name: Abraham Blamo Jr. id: >- pfbid0T3mwbF6JmWFsmwHE6KTCYT52jdGBMHACUoS3Kj8L82hD2SURiRmSEbVFXDeryFcyl url: >- https://www.facebook.com/people/Abraham-Blamo-Jr/pfbid0T3mwbF6JmWFsmwHE6KTCYT52jdGBMHACUoS3Kj8L82hD2SURiRmSEbVFXDeryFcyl/ avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t1.30497-1/453178253_471506465671661_2781666950760530985_n.png?stp=cp0_dst-png&cstp=mx2048x2048&ctp=s32x32&_nc_cat=1&ccb=1-7&_nc_sid=136b72&_nc_ohc=pBVtDPQheRgQ7kNvwFh2opW&_nc_oc=Adotivhq-mgLIPm-_M_TS57zgwxksv73uwGrXDx91e8mYuuwyGQeMPtrdR9bSHSomJE&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_ss=7f289&oh=00_AQKswV4dlIpAcZ-tuRgU4ot8oi4-o-HyYUdMSTnwDJwJjg&oe=6ACF433A verified: false reactions: 180 reactionsByType: - type: Like count: 142 - type: Love count: 25 - type: Care count: 3 replyCount: 21 createdAtMs: 1789293378000 createdAt: '2026-09-13T09:56:18.000Z' url: >- https://www.facebook.com/Cristiano/posts/pfbid0fM2WgsGPx9o374EVYJZUb53K22GniewZGAucD8rs1zMFM4oixfzjdrMXss1188f8l?comment_id=1717961155941240 isReshare: false sharedPost: null - postId: '1739600924193107' storyId: >- UzpfSTEwMDA0NDI5NjQ4NjM4MjoxNzM5NjAwOTI0MTkzMTA3OjE3Mzk2MDA5MjQxOTMxMDc= url: >- https://www.facebook.com/Cristiano/posts/pfbid0x34jsKEh22SwY2QgCQTii5rfSgcdL5fpWqSHhXYp5TfHRzqGeZZsH2oYyEZe1NwEl text: 😎 ✈️ author: name: Cristiano Ronaldo id: '100044296486382' url: https://www.facebook.com/Cristiano avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/724056214_1657518462401354_1550185043079196898_n.jpg?stp=c0.54.1366.1366a_cp0_dst-jpg_tt6&cstp=mx1366x1366&ctp=s40x40&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=a09PUl88X00Q7kNvwEHaN8A&_nc_oc=AdqCwiKuyFwo8qCPHlkHJuT-1etkgxJrgdYUmIioZ6KwOW1zQDDrIB8GfoV3i5ngppQ&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQI8J4OH-TWwxSgbeiZGgPM9-DVw5vT0L5oaXNbgjP9Ngw&oe=6AADC560 verified: null createdAt: '2026-09-11T13:42:15.000Z' createdTimestamp: 1789134135 media: type: photo videoId: null videoUrl: null videoHdUrl: null videoSdUrl: null thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/804648218_1079705651317787_7129949489923928016_n.png?stp=dst-jpg_tt6&cstp=mx3111x3889&ctp=s640x640&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=3efddKgUtAsQ7kNvwFkuQQQ&_nc_oc=AdpBhM9TxZn0ZsSds9FlUgA5quf9eTm1H07hsn4Z-3XgCfscrdur7nef7SRMcQHHH5Q&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQIsJqMlJQP3MSAvBYF9tmhjmPkGE68s1QYQEbrPYjhKKw&oe=6AADAA71 width: null height: null durationSeconds: null images: - >- https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/804648218_1079705651317787_7129949489923928016_n.png?stp=dst-jpg_tt6&cstp=mx3111x3889&ctp=s640x640&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=3efddKgUtAsQ7kNvwFkuQQQ&_nc_oc=AdpBhM9TxZn0ZsSds9FlUgA5quf9eTm1H07hsn4Z-3XgCfscrdur7nef7SRMcQHHH5Q&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQIsJqMlJQP3MSAvBYF9tmhjmPkGE68s1QYQEbrPYjhKKw&oe=6AADAA71 music: null link: null stats: reactions: 964588 reactionsByType: - type: Like count: 673369 - type: Love count: 250248 - type: Care count: 37189 comments: 28389 shares: 7481 views: null viewsLabel: null topComments: - id: >- Y29tbWVudDoxNzM5NjAwOTI0MTkzMTA3XzE3MDM1NjM5MDA3NDgxNTE= text: >- Argentina has Messi , Brazil has Neymar , England has Kane and the World has Ronaldo 🇵🇹 author: name: Md Johirul Islam Badsa id: '100063606885719' url: https://www.facebook.com/mdjohirulislam.badsa avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/672677452_1590738326389715_4782595842587243467_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1428x1428&ctp=s32x32&_nc_cat=107&ccb=1-7&_nc_sid=1d2534&_nc_ohc=o5pYB3mue3sQ7kNvwGfqupq&_nc_oc=Adom8I5qsr6Q48DvyVK6uxYY0uYQnRouhZWuk-JPEdBEYfSB-zcxetUcLXhj7olakLw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQLHFtwXeefwdjBmVQExvyVFX8NH18_kWPpdgVXXCqYdgQ&oe=6AADD370 verified: false reactions: 1200 reactionsByType: - type: Like count: 897 - type: Love count: 159 - type: Care count: 34 replyCount: 97 createdAtMs: 1789134190000 createdAt: '2026-09-11T13:43:10.000Z' url: >- https://www.facebook.com/Cristiano/posts/pfbid0x34jsKEh22SwY2QgCQTii5rfSgcdL5fpWqSHhXYp5TfHRzqGeZZsH2oYyEZe1NwEl?comment_id=1703563900748151 isReshare: false sharedPost: null - postId: '1738083501011516' storyId: >- UzpfSTEwMDA0NDI5NjQ4NjM4MjoxNzM4MDgzNTAxMDExNTE2OjE3MzgwODM1MDEwMTE1MTY= url: >- https://www.facebook.com/Cristiano/posts/pfbid02cs5zgXdGvt5fWfmteNfyYv9wbyzXmx6zBBvkQCMfw27uKqSs4ASpALJwJvbRfHBsl text: Hard work pays off 🟡🔵 author: name: Cristiano Ronaldo id: '100044296486382' url: https://www.facebook.com/Cristiano avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/724056214_1657518462401354_1550185043079196898_n.jpg?stp=c0.54.1366.1366a_cp0_dst-jpg_tt6&cstp=mx1366x1366&ctp=s40x40&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=a09PUl88X00Q7kNvwEHaN8A&_nc_oc=AdqCwiKuyFwo8qCPHlkHJuT-1etkgxJrgdYUmIioZ6KwOW1zQDDrIB8GfoV3i5ngppQ&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQI8J4OH-TWwxSgbeiZGgPM9-DVw5vT0L5oaXNbgjP9Ngw&oe=6AADC560 verified: null createdAt: '2026-09-09T20:08:47.000Z' createdTimestamp: 1788984527 media: type: photo videoId: null videoUrl: null videoHdUrl: null videoSdUrl: null thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/801963048_18771362614056421_7404328477539940267_n.jpg?stp=dst-jpg_tt6&cstp=mx3277x4096&ctp=s3277x4096&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=6foHs8UoMXYQ7kNvwH-TAa1&_nc_oc=AdpUy36UKyiwZBR9_Wl2EXp9tLZ1fp14SQv5NIk5sGbez-qqVc4IifiH8Z_LQh6MmQ0&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQJroyWoy2KZOCK7aOuIUZNkD2BPyuP0a2Fzlyh7HrMXMw&oe=6AADB2DF width: null height: null durationSeconds: null images: - >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/801963048_18771362614056421_7404328477539940267_n.jpg?stp=dst-jpg_tt6&cstp=mx3277x4096&ctp=s3277x4096&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=6foHs8UoMXYQ7kNvwH-TAa1&_nc_oc=AdpUy36UKyiwZBR9_Wl2EXp9tLZ1fp14SQv5NIk5sGbez-qqVc4IifiH8Z_LQh6MmQ0&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQJroyWoy2KZOCK7aOuIUZNkD2BPyuP0a2Fzlyh7HrMXMw&oe=6AADB2DF - >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/802307878_18771362611056421_7211335494025570908_n.jpg?stp=dst-jpg_tt6&cstp=mx3200x4000&ctp=s3200x4000&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=Q8raVkIDxa0Q7kNvwFbRanQ&_nc_oc=Ado4gwr_7tlKSzBwCEHLq-_ZExbG5M_P2iO-fFK-C0dnmTkCgfelCUATcuHNcPGkIDU&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQKhP0-by9JjZZ91QPHEDMWSU4lhgcF6yC_9GmvCvyDsVg&oe=6AADAAD4 - >- https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/801581563_18771362590056421_9198666560536280297_n.jpg?stp=dst-jpg_tt6&cstp=mx3277x4096&ctp=s3277x4096&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=HqEk2DW7eP0Q7kNvwGSO8fB&_nc_oc=AdrPLxUIqqquq-oyvlMzPxr7DcpEJXBx9oXh5B68ByuZzHwXio0pjGFUmYYv7T24n4o&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQKcTOFork80Ao3lzWnjyfSJpAzcM5Gna0sxrRo8c5TRzQ&oe=6AADB070 music: null link: null stats: reactions: 602231 reactionsByType: - type: Like count: 443266 - type: Love count: 136038 - type: Care count: 20612 comments: 14598 shares: 6137 views: null viewsLabel: null topComments: - id: >- Y29tbWVudDoxNzM4MDgzNTAxMDExNTE2XzE3NDM5MjE2NTM1NDg4NDk= text: |- IF FIFA decides, it's Messi If the world decides it's Ronaldo 💯 author: name: ثيو ثيو id: >- pfbid02WK32XF9aCizRqwhAoFxFuprwr9w6YqTRgsmgiaoqjd3eYhRXpMpjggYwYK7ziTD9l url: >- https://www.facebook.com/pfbid02WK32XF9aCizRqwhAoFxFuprwr9w6YqTRgsmgiaoqjd3eYhRXpMpjggYwYK7ziTD9l avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/696433629_122111690259274492_2679947236712265776_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx720x720&ctp=s32x32&_nc_cat=110&ccb=1-7&_nc_sid=e99d92&_nc_ohc=xOSY2eJHwPkQ7kNvwGUSKrz&_nc_oc=AdqeX43gRNvqr1B995N2UvR4Fao9RTImIVZJ3fAaFl72CoNKifqoQYvjbLxkl_j6Uy4&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=RdGzWqMNid3FlbrzsJTFvQ&_nc_ss=7f289&oh=00_AQIht0PSlpAk9JYwQZaW6g1Wog-8xWi_4-4QtfB14ON0BA&oe=6AADAD0F verified: false reactions: 910 reactionsByType: - type: Like count: 643 - type: Love count: 89 - type: Care count: 26 replyCount: 86 createdAtMs: 1788984565000 createdAt: '2026-09-09T20:09:25.000Z' url: >- https://www.facebook.com/Cristiano/posts/pfbid02cs5zgXdGvt5fWfmteNfyYv9wbyzXmx6zBBvkQCMfw27uKqSs4ASpALJwJvbRfHBsl?comment_id=1743921653548849 isReshare: false sharedPost: null postCount: 3 paging: cursor: >- Cg8Ob3JnYW5pY19jdXJzb3IJAAACmkFRSFQySHZhMVNGVXBVWDhZbGp5X3lHaWpzQ1JDY3BJS2ttdzhBdHRxNGZ6Y2lqeloyWFMtWlllN09QQ0lYeUpYdTlueHN4QXBjMVdpM1VoNnNEcUFuUDlNbjhCSUpCSFE2dXZFUmFJTzZKaFRidUNXZXVTcC01WGhxX1FpcDZ6b1Z4S0F2VzZvX0lPb3VJUndBbjMwVW1xc0RaWnRocS0wS2RLTFJobTVXLUxNN1Z1TzB1aWkxOTZzZE15eEFlakpqdm93Y2llZEJMWVNONmlFZnpDTExnUjRWenotSDYzVWUtellEYUlCYTFVc0RJZkFMaDlVZEp6cjRqejF6Um9pT1prSFZfUlpjcldmQmtibW56OXpqSEprSGNPVDRRcHZSTG1yak1kX2g4UVNKRHZmQmdQLTd4R2pRODVoS1N6RHlWZGg4NmI5OTJPWDdveko3anRPQVAyT1MwSUsxU0lsdWpWa3NwTGJSeUVPRmwxMWh3N3JUSHNXdlp6eGRlNFpUbEJQS0liU0pnRlNjRlhXcVpMZnVpTUZtdFlRak81MzU1WnJ5aHVhT0NuZWRsblZtQldONVQteDVFNHB6TkhjWnduVW83cG10TEotclQ4QThMc05SNVBtcUdQUG5mUEpfVF9NSlJlelg2RF9rbVVzbl9vMFVxdGttS1Z1MWZsWXVhc211M0JxNEpySmU0cDJReHNBbi1LU3BvT1AtX3ZSTFl3bGU2MEd5N3pvcDd0cnhFbXpNMlMwOGszY2ZsNU1vdC1nRFA5bTA2RWtkeEdUaTlwVmlwYS1LaXZibTl1Y2ZKMGlhbk5rWlpHR0o1LVNEV3lTODVocWkxOTlJZFVFdDZERmZrWjZXYWVhWFFTV1BKcWlCOFZGUQ8JYWRfY3Vyc29yDg8PZ2xvYmFsX3Bvc2l0aW9uAgAPBm9mZnNldAIADxBsYXN0X2FkX3Bvc2l0aW9uAv8B hasNextPage: true fetchedAt: '2026-09-14T12:13:48.121Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '400': description: Invalid or expired cursor. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: BAD_REQUEST message: The request was invalid. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Profile not found / no public posts. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (missing url and pageId). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '502': description: Upstream block. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source was temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ````