> ## 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.

# Profile posts

> Fetches a public Facebook profile/page's timeline posts (only publicly visible posts). Pass `url` OR `pageId` (the numeric profile id — faster). 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.

<Info>
  **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.
</Info>

<Accordion title="Copy for AI assistant" icon="sparkles">
  Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).

  ```text Prompt
  I want to make an API call to /v1/facebook/profile/posts. Here are the details:

  Endpoint: GET https://api.scraperize.com/v1/facebook/profile/posts
  Description: Fetches a public Facebook profile/page's timeline posts (only publicly visible posts). Pass `url` OR `pageId` (the numeric profile id — faster). 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.

  Required Headers:
  - x-api-key: Your API key

  Parameters:
  - url (string): **Required — provide one of `url` or `pageId`.** Public Facebook profile URL, e.g. https://www.facebook.com/Cristiano.
  - pageId (string): **Required — provide one of `url` or `pageId`.** Numeric profile id (faster than url).
  - cursor (string): The `paging.cursor` from a previous call, to fetch the next page.
  - cache_max_age (select): 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.

  Example Response:
  {
    "data": {
      "posts": [
        {
          "postId": "1757191985767334",
          "storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjoxNzU3MTkxOTg1NzY3MzM0OjE3NTcxOTE5ODU3NjczMzQ=",
          "url": "https://www.facebook.com/Cristiano/posts/pfbid02sAsoykNcMENEg7DTZoxYbGJccm4yrPRF8ksHP4PsYeT7hy9L53yzhc619z3ZigdCl",
          "text": "Após a conferência de imprensa do Selecionador Nacional, e no seguimento de uma conversa com o Presidente da Federação Portuguesa de Futebol, tomei a decisão de…",
          "author": {
            "name": "Cristiano Ronaldo",
            "id": "100044296486382",
            "url": "https://www.facebook.com/Cristiano",
            "avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=…",
            "verified": null
          },
          "createdAt": "2026-09-30T18:36:43.000Z",
          "createdTimestamp": 1790793403,
          "media": {
            "type": "photo",
            "videoId": null,
            "videoUrl": null,
            "videoHdUrl": null,
            "videoSdUrl": null,
            "thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/829136203_1608902097576513_7516733035385102623_n.png?stp=dst-jpg_tt6&cstp=mx1332x1666&ctp=s640x640&_nc_cat=10…",
            "width": null,
            "height": null,
            "durationSeconds": null,
            "images": [
              "https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/829136203_1608902097576513_7516733035385102623_n.png?stp=dst-jpg_tt6&cstp=mx1332x1666&ctp=s640x640&_nc_cat=10…"
            ],
            "music": null
          },
          "link": null,
          "stats": {
            "reactions": 2284381,
            "reactionsByType": [
              {
                "type": "Like",
                "count": 1293723
              }
            ],
            "comments": 188146,
            "shares": 124534,
            "views": null,
            "viewsLabel": null
          },
          "topComments": [
            {
              "id": "Y29tbWVudDoxNzU3MTkxOTg1NzY3MzM0XzQyMDUyMTU0NDY0MzYzNjQ=",
              "text": "When Ronaldo is happy the world is happy except particular group of people",
              "author": {
                "name": "Bilen Bahta",
                "id": "pfbid0ePzmwJnoZW7W6e7pqYQVwwMDohXQL1H5V72GFREzstS48iF1pjBQiuaCHUHYAQr8l",
                "url": "https://www.facebook.com/pfbid0ePzmwJnoZW7W6e7pqYQVwwMDohXQL1H5V72GFREzstS48iF1pjBQiuaCHUHYAQr8l",
                "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=…",
                "verified": false
              },
              "reactions": 16000,
              "reactionsByType": [
                {
                  "type": "Like",
                  "count": 13701
                }
              ],
              "replyCount": 526,
              "createdAtMs": 1790793985000,
              "createdAt": "2026-09-30T18:46:25.000Z",
              "url": "https://www.facebook.com/Cristiano/posts/pfbid02sAsoykNcMENEg7DTZoxYbGJccm4yrPRF8ksHP4PsYeT7hy9L53yzhc619z3ZigdCl?comment_id=4205215446436364"
            }
          ],
          "isReshare": false,
          "sharedPost": null
        }
      ],
      "postCount": 3,
      "paging": {
        "cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAACmkFRSFREVlpaN0xGbWxYUUZZNUJYU0xSVkJYNEJ3cXNnMG5yUDJDTDZtMzB0UlZXekNwaXcwTS0wVE1QcUNPYTNaeTlsX3ZRZFVyWmJRWTNFak1XSHl1MThPRnVRTmZnTjJE…",
        "hasNextPage": true
      },
      "fetchedAt": "2026-10-05T14:42:59.313Z"
    },
    "meta": {
      "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
      "creditsCharged": 1,
      "creditsRemaining": 4999,
      "cached": false
    }
  }

  Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
  ```
</Accordion>


## 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
    <key>`). 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: LinkedIn
    description: LinkedIn scraping endpoints
  - name: Twitch
    description: Twitch scraping endpoints
  - name: TikTok
    description: TikTok (tiktok.com) scraping endpoints
paths:
  /v1/facebook/profile/posts:
    get:
      tags:
        - Facebook
      summary: Profile posts
      description: >-
        Fetches a public Facebook profile/page's timeline posts (only publicly
        visible posts). Pass `url` OR `pageId` (the numeric profile id —
        faster). 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: '1757191985767334'
                      storyId: >-
                        UzpfSTEwMDA0NDI5NjQ4NjM4MjoxNzU3MTkxOTg1NzY3MzM0OjE3NTcxOTE5ODU3NjczMzQ=
                      url: >-
                        https://www.facebook.com/Cristiano/posts/pfbid02sAsoykNcMENEg7DTZoxYbGJccm4yrPRF8ksHP4PsYeT7hy9L53yzhc619z3ZigdCl
                      text: >-
                        Após a conferência de imprensa do Selecionador Nacional,
                        e no seguimento de uma conversa com o Presidente da
                        Federação Portuguesa de Futebol, tomei a decisão de
                        deixar o estágio da Seleção Nacional.


                        A seu tempo, direi a verdade a todos os Portugueses
                        sobre as razões que motivaram a minha saída da equipa
                        nacional, à qual sempre me dediquei.  


                        Agora é tempo de desejar boa sorte a Portugal e a todos
                        os meus companheiros de equipa, sem exceção.
                      author:
                        name: Cristiano Ronaldo
                        id: '100044296486382'
                        url: https://www.facebook.com/Cristiano
                        avatarUrl: >-
                          https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s40x40&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQMqURHtJJdSv2VLEwyPB_aV77PMYKDWhlX8OSBH8VfW5g&oe=6AC99D6E
                        verified: null
                      createdAt: '2026-09-30T18:36:43.000Z'
                      createdTimestamp: 1790793403
                      media:
                        type: photo
                        videoId: null
                        videoUrl: null
                        videoHdUrl: null
                        videoSdUrl: null
                        thumbnailUrl: >-
                          https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/829136203_1608902097576513_7516733035385102623_n.png?stp=dst-jpg_tt6&cstp=mx1332x1666&ctp=s640x640&_nc_cat=108&ccb=1-7&_nc_sid=127cfc&_nc_ohc=brEMrIn3F6cQ7kNvwE-St8X&_nc_oc=Adp48Ccw1u9OFN2TUxPeIbyWf_hSkNlZdRDn9R1e1nhhHy6DaQ4rn5upYwyPEdvK4Cc&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQMX8ESpvrKuV-jEIClqgyvtVSeNnd_77sGOGHLZY8ISmg&oe=6AC97B15
                        width: null
                        height: null
                        durationSeconds: null
                        images:
                          - >-
                            https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/829136203_1608902097576513_7516733035385102623_n.png?stp=dst-jpg_tt6&cstp=mx1332x1666&ctp=s640x640&_nc_cat=108&ccb=1-7&_nc_sid=127cfc&_nc_ohc=brEMrIn3F6cQ7kNvwE-St8X&_nc_oc=Adp48Ccw1u9OFN2TUxPeIbyWf_hSkNlZdRDn9R1e1nhhHy6DaQ4rn5upYwyPEdvK4Cc&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQMX8ESpvrKuV-jEIClqgyvtVSeNnd_77sGOGHLZY8ISmg&oe=6AC97B15
                        music: null
                      link: null
                      stats:
                        reactions: 2284381
                        reactionsByType:
                          - type: Like
                            count: 1293723
                          - type: Love
                            count: 418377
                          - type: Care
                            count: 62676
                        comments: 188146
                        shares: 124534
                        views: null
                        viewsLabel: null
                      topComments:
                        - id: >-
                            Y29tbWVudDoxNzU3MTkxOTg1NzY3MzM0XzQyMDUyMTU0NDY0MzYzNjQ=
                          text: >-
                            When Ronaldo is happy the world is happy except
                            particular group of people
                          author:
                            name: Bilen Bahta
                            id: >-
                              pfbid0ePzmwJnoZW7W6e7pqYQVwwMDohXQL1H5V72GFREzstS48iF1pjBQiuaCHUHYAQr8l
                            url: >-
                              https://www.facebook.com/pfbid0ePzmwJnoZW7W6e7pqYQVwwMDohXQL1H5V72GFREzstS48iF1pjBQiuaCHUHYAQr8l
                            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=v_XEyutpHp0Q7kNvwFcO8kh&_nc_oc=AdqQzms0u9JE-Ltxj5LrK8qvsQ-0lc7PeEmWrq30yBRRfdebaqpUBF8HuwxSxQmnQUI&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_ss=7c289&oh=00_AQNLv6lnDomskeH_oHjiLdKghs9tpf-_8AIjBxv1zs9CTw&oe=6AEB2AFA
                            verified: false
                          reactions: 16000
                          reactionsByType:
                            - type: Like
                              count: 13701
                            - type: Love
                              count: 513
                            - type: Care
                              count: 112
                          replyCount: 526
                          createdAtMs: 1790793985000
                          createdAt: '2026-09-30T18:46:25.000Z'
                          url: >-
                            https://www.facebook.com/Cristiano/posts/pfbid02sAsoykNcMENEg7DTZoxYbGJccm4yrPRF8ksHP4PsYeT7hy9L53yzhc619z3ZigdCl?comment_id=4205215446436364
                      isReshare: false
                      sharedPost: null
                    - postId: '1756147589205107'
                      storyId: >-
                        UzpfSTEwMDA0NDI5NjQ4NjM4MjoxNzU2MTQ3NTg5MjA1MTA3OjE3NTYxNDc1ODkyMDUxMDc=
                      url: >-
                        https://www.facebook.com/Cristiano/posts/pfbid0WbeaMrgJFeCD89mF4X7WwvFm56VbXRV52p7up9PqK7Uu7e6URsH7kykRRjvz5soXl
                      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/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s40x40&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQMqURHtJJdSv2VLEwyPB_aV77PMYKDWhlX8OSBH8VfW5g&oe=6AC99D6E
                        verified: null
                      createdAt: '2026-09-29T17:44:02.000Z'
                      createdTimestamp: 1790703842
                      media:
                        type: photo
                        videoId: null
                        videoUrl: null
                        videoHdUrl: null
                        videoSdUrl: null
                        thumbnailUrl: >-
                          https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/825292799_2398776584216276_169291896869886441_n.png?stp=dst-jpg_tt6&cstp=mx1330x1664&ctp=s640x640&_nc_cat=107&ccb=1-7&_nc_sid=127cfc&_nc_ohc=8kfZoLbdzeIQ7kNvwE7vvlB&_nc_oc=AdqcfLuGPQ2VplNk2O_smW0WH1dFmFhHrL9e2Q7xYRJRbh5XwO-PdSbwwJ70oJcg5Zs&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQP9hoHSU6M1Ffvlaa5L1KF5ObYn8Y431K9tewQBXuqLPQ&oe=6AC973DE
                        width: null
                        height: null
                        durationSeconds: null
                        images:
                          - >-
                            https://scontent-los4-1.xx.fbcdn.net/v/t39.99422-6/825292799_2398776584216276_169291896869886441_n.png?stp=dst-jpg_tt6&cstp=mx1330x1664&ctp=s640x640&_nc_cat=107&ccb=1-7&_nc_sid=127cfc&_nc_ohc=8kfZoLbdzeIQ7kNvwE7vvlB&_nc_oc=AdqcfLuGPQ2VplNk2O_smW0WH1dFmFhHrL9e2Q7xYRJRbh5XwO-PdSbwwJ70oJcg5Zs&_nc_zt=14&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQP9hoHSU6M1Ffvlaa5L1KF5ObYn8Y431K9tewQBXuqLPQ&oe=6AC973DE
                        music: null
                      link: null
                      stats:
                        reactions: 952376
                        reactionsByType:
                          - type: Like
                            count: 640324
                          - type: Love
                            count: 269827
                          - type: Care
                            count: 33567
                        comments: 21363
                        shares: 8286
                        views: null
                        viewsLabel: null
                      topComments:
                        - id: >-
                            Y29tbWVudDoxNzU2MTQ3NTg5MjA1MTA3XzI4NzUzMDY2OTk0OTM3OTA=
                          text: >-
                            Messi has won ,just one world cup trophy. But
                            Cristiano Ronaldo has won the love of people around
                            the world...✅✅✅
                          author:
                            name: Rasel Ahmed
                            id: >-
                              pfbid0iDoUyh1yEn6h7NWJzogekGpXaUjxjKRb7woT7b3xdc5zAMcrrkyay3xzSARUbfE7l
                            url: >-
                              https://www.facebook.com/pfbid0iDoUyh1yEn6h7NWJzogekGpXaUjxjKRb7woT7b3xdc5zAMcrrkyay3xzSARUbfE7l
                            avatarUrl: >-
                              https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/676592075_122094988550539916_3365744643286994415_n.jpg?stp=c0.120.720.720a_cp0_dst-jpg_tt6&cstp=mx720x720&ctp=s32x32&_nc_cat=107&ccb=1-7&_nc_sid=e99d92&_nc_ohc=KTPphaF48b4Q7kNvwG_xhEQ&_nc_oc=AdpKVkL2Vr9BRqnIQnXd1eirw0cQ-GfN2lPu4QpG8_Dm3DJt2kRZKIIjFkwMM3eo1iU&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQObp4ndOzGKCm5k3ArLejRxm-NJ8KNWbu1w2_pTapo-Cg&oe=6AC97660
                            verified: false
                          reactions: 2500
                          reactionsByType:
                            - type: Like
                              count: 2006
                            - type: Love
                              count: 220
                            - type: Care
                              count: 24
                          replyCount: 156
                          createdAtMs: 1790704211000
                          createdAt: '2026-09-29T17:50:11.000Z'
                          url: >-
                            https://www.facebook.com/Cristiano/posts/pfbid0WbeaMrgJFeCD89mF4X7WwvFm56VbXRV52p7up9PqK7Uu7e6URsH7kykRRjvz5soXl?comment_id=2875306699493790
                      isReshare: false
                      sharedPost: null
                    - postId: '1751351049684761'
                      storyId: >-
                        UzpfSTEwMDA0NDI5NjQ4NjM4MjoxNzUxMzUxMDQ5Njg0NzYxOjE3NTEzNTEwNDk2ODQ3NjE=
                      url: >-
                        https://www.facebook.com/Cristiano/posts/pfbid02H9n4r9aRVfGJ6UzMUg88zFwdTZTa4u7t6yzXbbn8FPPRUoKJzK4er4y8omJwBxNtl
                      text: Primeiro passo dado. Vamos, Portugal!
                      author:
                        name: Cristiano Ronaldo
                        id: '100044296486382'
                        url: https://www.facebook.com/Cristiano
                        avatarUrl: >-
                          https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s40x40&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQMqURHtJJdSv2VLEwyPB_aV77PMYKDWhlX8OSBH8VfW5g&oe=6AC99D6E
                        verified: null
                      createdAt: '2026-09-24T21:12:36.000Z'
                      createdTimestamp: 1790284356
                      media:
                        type: photo
                        videoId: null
                        videoUrl: null
                        videoHdUrl: null
                        videoSdUrl: null
                        thumbnailUrl: >-
                          https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/823964759_18776515597056421_2004768802209950397_n.jpg?stp=dst-jpg_tt6&cstp=mx1066x1331&ctp=s1066x1331&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=q0dAS7IEm1QQ7kNvwGNkumT&_nc_oc=Adq0tjjlvEEkaFxBCs0mTHMvAXLlkao9KXYzd5TfNrpPwx9lQS4CYkwFhZBIPd7v05M&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQMukZaCYVYnRJFYX1Q0cF0qxFIzOFgn035XU0RKfAg8_g&oe=6AC9A239
                        width: null
                        height: null
                        durationSeconds: null
                        images:
                          - >-
                            https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/823964759_18776515597056421_2004768802209950397_n.jpg?stp=dst-jpg_tt6&cstp=mx1066x1331&ctp=s1066x1331&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=q0dAS7IEm1QQ7kNvwGNkumT&_nc_oc=Adq0tjjlvEEkaFxBCs0mTHMvAXLlkao9KXYzd5TfNrpPwx9lQS4CYkwFhZBIPd7v05M&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQMukZaCYVYnRJFYX1Q0cF0qxFIzOFgn035XU0RKfAg8_g&oe=6AC9A239
                          - >-
                            https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/818909712_18776515588056421_6812528740852732351_n.jpg?stp=dst-jpg_tt6&cstp=mx1066x1331&ctp=s1066x1331&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=J2AuYXlc6TwQ7kNvwEu9LMN&_nc_oc=AdqEfvHHUJfW7KWNOBl-2OMHcLLvUdVOta8eFkbf5ajOLib3ZKdJ0l0HXmzCmGtYY6Y&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQM_0wDp6cGim_KqrRnVnW6TmKr63LGzPKS3KoYb0U-yTg&oe=6AC9A3D7
                          - >-
                            https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-15/817624899_18776515579056421_5849250287404031021_n.jpg?stp=dst-jpg_tt6&cstp=mx1066x1331&ctp=s1066x1331&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=HlMyM7_I9acQ7kNvwEZKbpC&_nc_oc=Adr1sqZWpElkU8EYAAEArqgYAUL46_wuiw_wK5iQ41srbcmpZeYbDrxVtt4d393LNV4&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQPIYZQNg138rbBv03JL0rPGJVl0_cO1pVDcGTn8KtYK9A&oe=6AC984E6
                        music: null
                      link: null
                      stats:
                        reactions: 511937
                        reactionsByType:
                          - type: Like
                            count: 350275
                          - type: Love
                            count: 138978
                          - type: Care
                            count: 18403
                        comments: 12631
                        shares: 9310
                        views: null
                        viewsLabel: null
                      topComments:
                        - id: >-
                            Y29tbWVudDoxNzUxMzUxMDQ5Njg0NzYxXzE3NDkzOTYzMzk2NjIxMjc=
                          text: >-
                            When Ronaldo doesn't score, the world start talking
                            about Ronaldo. 

                            When Ronaldo scores, the world talk again about
                            Ronaldo. 

                            But if Messi scores, the world always talk about
                            Ronaldo. 

                            And if he doesn't score too, the world still keep
                            talking about Ronaldo.😱

                            It's really difficult to be a Ronaldo
                          author:
                            name: Real stephano
                            id: '61575138205375'
                            url: >-
                              https://www.facebook.com/people/Real-stephano/61575138205375/
                            avatarUrl: >-
                              https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/788880712_122187439694837940_3946562527287845660_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx720x730&ctp=s32x32&_nc_cat=108&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=ichatTWFje4Q7kNvwGymLLW&_nc_oc=Adq9wJkk6DtR-5VoOKFCcA6buo0CTMi4nCpCvALQ_bu61Vo5k7ViZXSl6oz9m7D1qVY&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=MuNL3cRwftyMzQl-crjISA&_nc_ss=7c289&oh=00_AQO14kKMjLxJwp3katXZXFaIVROuzT941L2PwGkHD5m2pg&oe=6AC97F28
                            verified: false
                          reactions: 1200
                          reactionsByType:
                            - type: Like
                              count: 1014
                            - type: Love
                              count: 113
                            - type: Care
                              count: 18
                          replyCount: 130
                          createdAtMs: 1790284569000
                          createdAt: '2026-09-24T21:16:09.000Z'
                          url: >-
                            https://www.facebook.com/Cristiano/posts/pfbid02H9n4r9aRVfGJ6UzMUg88zFwdTZTa4u7t6yzXbbn8FPPRUoKJzK4er4y8omJwBxNtl?comment_id=1749396339662127
                      isReshare: false
                      sharedPost: null
                  postCount: 3
                  paging:
                    cursor: >-
                      Cg8Ob3JnYW5pY19jdXJzb3IJAAACmkFRSFREVlpaN0xGbWxYUUZZNUJYU0xSVkJYNEJ3cXNnMG5yUDJDTDZtMzB0UlZXekNwaXcwTS0wVE1QcUNPYTNaeTlsX3ZRZFVyWmJRWTNFak1XSHl1MThPRnVRTmZnTjJEMjJ2bnphUjJSYnJSUHp2bDFNMmJMY1RBRFgzYmo1M3lMbjhBX3psV2Rvd0kzaWhMTjJOV0h4SEpuWWZlTWZXaUJqVlBXbEg4QUFIV3k0a05CQl9wSk4yWVJ0NEV0aHFuZWkzdWEyS2ZWdU9sY2ViNkwzYjBnZVdmcnpOeXRHSnI1YzY2SmFYTjVLcDRzRkZvaGZTZ3pUcXlpNFBtRUJkWkdCVEtFcHBnYXhJY0prQ0p5Tlo1RWZPREpsalZUNWl4SVRpZV9pYnRSMXBVSlFsbjNfXzVTazZWbGZUd3pVcWowdmVOVUVPMlVDMGtpeXNOZldBckFJSEcweTg2REV1Vy0ySzBGaEtyN2xubDV0UGswMzI1MlYwV1VidnluRlY4RjA4dmVaTDlpVS02VHNmUElhcnRaZEZKdE4xOEVZb2JrY0tkYnF0VXczam5iLXRqR3BYZDBiTDJ4WWt6TE5oNEtpREZaRkhlQU9NcUJ0NDhaaE41NmF1NnY3elhvTkdkM1ZzUFQyaGVncW5PV3c5SEtLZFpDSXA1RFQ4MnE1NFgwOS1UUkpMSE5ZeENYamtLc3lNMGNzb2w0bUVPYnNCRzhOV085bDA5c2lxaHVORTVqS3NfYjZKMzVUektOZXB4MVhwTGZTYnhiQjI5UzRVYjVhS05aeHczWnIzWVRCRl9QaHpWaXo0cHhBTkM3Y2xaRW1HRWswamptRWRxVFFiTVJoXzRaN21LTmd0MWlSUFZVNnpYdzBVUQ8JYWRfY3Vyc29yDg8PZ2xvYmFsX3Bvc2l0aW9uAgAPBm9mZnNldAIADxBsYXN0X2FkX3Bvc2l0aW9uAv8B
                    hasNextPage: true
                  fetchedAt: '2026-10-05T14:42:59.313Z'
                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
        '503':
          description: >-
            Temporarily unavailable — retry after `Retry-After`. `error.code`
            tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
            `EXTRACTION_FAILED` (the source returned unexpected data),
            `PLATFORM_UNAVAILABLE` (the source is down), or
            `SERVICE_UNAVAILABLE` (we are at capacity).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: UPSTREAM_BLOCKED
                  message: >-
                    The source is 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 <key>`). Create and manage keys from your dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.