> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Profile Posts

> Get publicly visible posts from a Facebook profile — equivalent to what is accessible without being logged in. Accepts a profile URL or pageId (recommended for faster responses). Returns up to 3 posts per request.

<Note>
  💳 **1 credit** per request
</Note>


## OpenAPI

````yaml GET /v1/scrape/facebook/profile/posts
openapi: 3.1.0
info:
  title: SociaVault API
  version: 1.0.0
  description: >-
    # SociaVault API Documentation


    The SociaVault API provides comprehensive access to social media data
    extraction across multiple platforms.


    ## Features


    - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
    Reddit, Threads, and more

    - **Credit-Based System**: Pay-as-you-go pricing with transparent credit
    costs

    - **High Performance**: Fast, reliable data extraction

    - **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
    and analytics


    ## Authentication


    All API requests require authentication using an API key in the `X-API-Key`
    header:


    ```bash

    X-API-Key: sk_live_your_api_key_here

    ```


    Get your API key from the [SociaVault
    Dashboard](https://sociavault.com/dashboard).


    ## Credits


    Each endpoint consumes credits based on data complexity:

    - Simple requests (profiles): 1 credit

    - Complex requests (demographics): 20+ credits

    - Paginated requests: Credits per page


    Check your credit balance in the dashboard or via the API.


    ## Support


    - **Documentation**: https://docs.sociavault.com

    - **Email**: support@sociavault.com

    - **Discord**: https://discord.gg/sociavault
  contact:
    name: SociaVault Support
    email: support@sociavault.com
    url: https://sociavault.com/support
  license:
    name: Commercial
    url: https://sociavault.com/terms
servers:
  - url: https://api.sociavault.com
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: account
    description: Account management and credit balance
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/account
  - name: tiktok
    description: Scrape TikTok profiles, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok
  - name: tiktok-shop
    description: Everything about TikTok Shop
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok-shop
  - name: instagram
    description: Gets Instagram profiles, posts, and reels
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/instagram
  - name: youtube
    description: Scrape YouTube channels, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/youtube
  - name: linkedin
    description: Scrape LinkedIn
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedin
  - name: facebook
    description: Get public Facebook profiles and posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebook
  - name: facebookAdLibrary
    description: Scrapes the Facebook (Meta) Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookAdLibrary
  - name: facebookMarketplace
    description: Search Facebook Marketplace and pull full listing details
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookMarketplace
  - name: googleAdLibrary
    description: >-
      Scrape the Google Ad Transparency Library. *This only gets the public ads.
      Some ads you need to log in for and sadly we can't get those. Also, since
      there are so many variations, the return types might not all be 100% the
      same.
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/googleAdLibrary
  - name: linkedinAdLibrary
    description: Search the LinkedIn Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedinAdLibrary
  - name: twitter
    description: Get Twitter profiles, tweets, followers and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/twitter
  - name: reddit
    description: Scrape Reddit posts and comments
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/reddit
  - name: threads
    description: Get Threads posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/threads
  - name: google
    description: Scrape Google search results
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/google
paths:
  /v1/scrape/facebook/profile/posts:
    get:
      tags:
        - facebook
      summary: Profile Posts
      description: >-
        Get publicly visible posts from a Facebook profile — equivalent to what
        is accessible without being logged in. Accepts a profile URL or pageId
        (recommended for faster responses). Returns up to 3 posts per request.
      operationId: facebook_Profile_Posts
      parameters:
        - name: url
          in: query
          description: Facebook profile URL
          required: false
          schema:
            type: string
            example: https://www.facebook.com/pacemorby
        - name: pageId
          in: query
          description: Facebook profile page id
          required: false
          schema:
            type: string
            example: '100063669491743'
        - name: cursor
          in: query
          description: To paginate through the posts
          required: false
          schema:
            type: string
            example: Cg8Ob3JnYW5pY19jdXJzb3IJA...
      responses:
        '200':
          description: >-
            Successful response


            **Key Response Fields:**

            - `data.posts[0].id`: Post ID

            - `data.posts[0].text`: Post text/caption

            - `data.posts[0].url`: Direct URL to the post or reel

            - `data.posts[0].author.name`: Name of the page that posted

            - `data.posts[0].reactionCount`: Total reaction (like/love/etc.)
            count

            - `data.posts[0].commentCount`: Total comment count

            - `data.posts[0].publishTime`: Unix timestamp of when the post was
            published

            - `data.posts[0].videoDetails.sdUrl`: SD video stream URL (if a
            video post)

            - `data.posts[0].videoDetails.hdUrl`: HD video stream URL (if a
            video post)

            - `data.posts[0].videoDetails.thumbnailUrl`: Video thumbnail URL

            - `data.posts[0].image`: Static post image URL (for image posts)

            - `data.cursor`: Pagination cursor — pass as `cursor` to get the
            next 3 posts
          content:
            application/json:
              example:
                success: true
                data:
                  success: true
                  posts:
                    '0':
                      id: '1530759742389661'
                      text: >-
                        Most people never reach their Mount Everest because they
                        never define it.


                        “Be successful” is not a mountain.

                        It’s just a direction.


                        Your Mount Everest is the end goal.


                        To define it clearly, use a framework like SMART. Here’s
                        what that might look like:


                        Specific:

                        Define the exact life you want, not just the next move.


                        Measurable:

                        Income, time freedom, control, impact. Put numbers to
                        it.


                        Achievable:

                        Big enough to matter. Real enough to pursue.


                        Relevant:

                        Aligned with your values and what you truly want to
                        accomplish in life.


                        Time-bound:

                        A clear timeline to make it happen. No one ever made an
                        “eventually” goal and stuck to it.


                        A real Mount Everest sounds something like this:

                        “I want to cash flow 100k/month before 2040 by focusing
                        on RV parks and mobile homes so I can ensure financial
                        freedom and spend more time on my hobbies and with
                        family without the headache and constant stress of
                        work.”


                        That’s the mountain.

                        Everything else is just the path.


                        Define the end goal.

                        Then work backward.
                      url: https://www.facebook.com/reel/1020832793820089/
                      permalink: https://www.facebook.com/reel/1020832793820089/
                      author:
                        __typename: User
                        name: Pace Morby
                        short_name: Pace Morby
                        id: '100063669491743'
                      videoDetails:
                        sdUrl: >-
                          https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMQwlyJ3SL04ySrg56moM2o9XaGGC66aUpTP54bhsfgKmIDPcI2hozN_CGYxdawngPXo7B8DVnDQ0gSC2pRRXwIRJsFbT_gPRophAa75A.mp4?_nc_cat=103&_nc_sid=8bf8fe&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=TWWiBycP0tYQ7kNvwGTi0m7&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NDIzNTc0Mzg2MDAxODc5NCwiYXNzZXRfYWdlX2RheXMiOjQzLCJ2aV91c2VjYXNlX2lkIjoxMDEyNywiZHVyYXRpb25fcyI6ODAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=wyxwHqw83Znfal86BF7KbQ&_nc_zt=28&oh=00_Afu8t_JDYCbMYqmNsUFzx1WqLYhFv9jziwxdHMJ0RNBW-A&oe=698EDE73&bitrate=224776&tag=sve_sd
                        hdUrl: >-
                          https://video-atl3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQMFD3iiKC5e5TiUnSFJ9ovUH1aWUnjrDdkdngz42z7fGxgbpy4vtKk4XKOA-uJ17HlwooTebdSekSj-29XdqGCX_6HqbKIKDktXTu308oEZHQ.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=video-atl3-2.xx.fbcdn.net&_nc_ohc=M15IcfI44GEQ7kNvwGY_fol&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjQyMzU3NDM4NjAwMTg3OTQsImFzc2V0X2FnZV9kYXlzIjo0MywidmlfdXNlY2FzZV9pZCI6MTAxMjcsImR1cmF0aW9uX3MiOjgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=83b4170c6f23c54&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC8yNzQxNkQ5NjI1MDRGNEY0MzU4MDhENjA1QjVFRjA5Q19tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0JENDlBRDM1OUZGRkQxMTRBNjc2RjI2RkJGRkFFRjlBX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbUuZaC35iGDxUCKAJDMywXQFQKn752yLQYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZ6eAQA&_nc_gid=wyxwHqw83Znfal86BF7KbQ&_nc_zt=28&oh=00_AfvyOcpT_27LpsDu5TvObBNwx1WRj5ZgMX1o_rwTcv2Twg&oe=698F0510&bitrate=664806&tag=dash_h264-basic-gen2_720p
                        thumbnailUrl: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/608335501_1020833387153363_190016405962712638_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=be8305&_nc_ohc=yyYe-qsz1YwQ7kNvwFvUJii&_nc_oc=AdnMzKjdwf8lubyjcxmFUMM2psRXy-Gw7Xkj7laZU89MJszOvMegfzjH1_OeQZcjiIA&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=wyxwHqw83Znfal86BF7KbQ&oh=00_AfsmkkFinhvKN7PRv2L2YU8KmFDisySgjlE6nITHfJAJHg&oe=698EE9CF
                      image: >-
                        https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/608335501_1020833387153363_190016405962712638_n.jpg?stp=dst-jpg_p565x565_tt6&_nc_cat=104&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=yyYe-qsz1YwQ7kNvwFvUJii&_nc_oc=AdnMzKjdwf8lubyjcxmFUMM2psRXy-Gw7Xkj7laZU89MJszOvMegfzjH1_OeQZcjiIA&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=wyxwHqw83Znfal86BF7KbQ&oh=00_Afs35klV4U_Dw8K5gSI9C5xl-igDBtSWg75_POU8Y6pCfg&oe=698EE9CF
                      reactionCount: 310
                      commentCount: 20
                      videoViewCount: null
                      publishTime: 1766806463
                      topComments: {}
                  cursor: >-
                    Cg8Ob3JnYW5pY19jdXJzb3IJAAAB2kFRSFN1UFVxSUdFaV9WTElYcDRuNHdNNE41SDU5WGtBY2RrSFpSRWFEWUo2N1Uwa1BVRHQ1WVNJeEhia1E0cWZwLVotQnFlYnd0ZkNWSnBURWFJVUxaZlJONk1kM3o2T3ZBVTQzMzhIS2tzSWJOVnYxUFNhZU8ybFNVN000cnMxdlRwNVBoLUJBeDFhZHFEWlhJd1R0d2Q1Tk5TZDFOSEV0WnpKa185VFBTVW8wSGJONmFhLURBQXFxQmxWMTNnWUR3ZEpTSnh5SzF4NlRPMERuZkUycHE5aEdpY3V3bDljQnlBcUxoNm5JdUU1TTFoMm9vZWlja3hzMmVzdTRjc2xVb25hZTJIQzZSSTVuQUJBaGpZWHBVY0FvSVMzZHJZQmZxSWFRbTBDei1pbEdObUVLam1KX2dDSlQ3QWFrYU83MGZub3NNRUlMTThNNVBqVzNRdmg1TGU5aGsxNFBQeVFMeTJ5SVpJZno2ZjJZRk53NEtjZ0dnZFV2NjcxUWxfcF9hX2JkV2Y5Yl9aYkF0QkRBSDZZZ2dnVzBBd1NQVzAyYktMZjBaZTQ4UEFVV1Z5ZkJZMkJzX01lRldDVmFTQlRyTnpzR2hLMmd2Zzc2dWVjemM2RTdDQl9xdw8JYWRfY3Vyc29yDg8PZ2xvYmFsX3Bvc2l0aW9uAgAPBm9mZnNldAIADxBsYXN0X2FkX3Bvc2l0aW9uAv8B
                credits_used: 1
                endpoint: facebook/profile/posts
        '400':
          description: Bad Request - Invalid parameters or missing required fields
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: 'Missing required parameter: handle'
                  endpoint:
                    type: string
                  credits_required:
                    type: integer
                required:
                  - error
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid API key
                  docs:
                    type: string
                    example: https://docs.sociavault.com/authentication
                required:
                  - error
        '402':
          description: Payment Required - Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Insufficient credits
                  required:
                    type: integer
                    example: 1
                    description: Credits required for this request
                  available:
                    type: integer
                    example: 0
                    description: Credits currently available
                required:
                  - error
                  - required
                  - available
        '500':
          description: Internal Server Error - Service configuration or processing error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Service configuration error
                required:
                  - error
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`

        Get your API key from the [Dashboard](https://sociavault.com/dashboard).

````