scraper-api-com

scraper-api-com Facebook API

Facebook: read-only. 6 public endpoints, no account needed.

Documentation GitHub OpenAPI

Operations 6

GET /v1/facebook/profile Get a Facebook page/profile by URL (name, category, photos, likes, followers) #

GET /v1/facebook/profile/posts Get a Facebook page's posts (message, reactions, comments, shares); paginate… #

GET /v1/facebook/post Get a single Facebook post by URL (message, reactions, comments, shares, video) #

GET /v1/facebook/post/comments Get the comments on a Facebook post by URL (embedded top comments; full list… #

GET /v1/facebook/profile/reels Get a Facebook page's videos/reels (id, title, thumbnail, play count) #

GET /v1/facebook/profile/photos Get a Facebook page's photos (id, image url, link) #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/scraper-api-com/openapi/scraper-api-com-facebook-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/scraper-api-com:scraper-api-com-facebook-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: scraper-api.com Facebook API
  version: 0.1.0
  description: 'Self-hosted social media scraping API — a drop-in replacement for scrapecreators.com.


    ## Authentication

    Every request must send your API key in the `x-api-key` header.


    ## Credits

    Billing is credit-based: **1 request = 1 credit** (some endpoints cost more — see each endpoint''s description). Credits are **non-expiring** — buy once, use whenever.


    Response bodies match the ScrapeCreators shapes so existing integrations work unchanged.'
  contact:
    name: Fabian Bitter
    email: fabian@bitter.de
servers:
- url: https://api.scraper-api.com
  description: Production
security:
- apiKeyAuth: []
tags:
- name: Facebook
  description: 'Facebook: read-only. 6 public endpoints, no account needed.'
paths:
  /v1/facebook/profile:
    get:
      tags:
      - Facebook
      summary: Get a Facebook page/profile by URL (name, category, photos, likes, followers)
      operationId: facebook_v1_profile
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: url
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: pageId
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: handle
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                success: true
                id: '100044561550831'
                name: NASA - National Aeronautics and Space Administration
                url: https://www.facebook.com/NASA
                isPrivate: false
                gender: null
                category: Government organization
                pageIntro: Explore the universe and discover our home planet.
                profilePhoto: https://scontent.fbcdn.net/mock-profile.png
                coverPhoto: https://scontent.fbcdn.net/mock-cover.jpg
                likeCount: 28664399
                followerCount: 28664399
                verified: true
                email: null
                phone: null
                website: null
                address: null
                creationDate: null
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
  /v1/facebook/profile/posts:
    get:
      tags:
      - Facebook
      summary: Get a Facebook page's posts (message, reactions, comments, shares); paginate…
      operationId: facebook_v1_profile_posts
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: url
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: pageId
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: handle
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                posts:
                - id: '1576597780502259'
                  text: '"Never a dull moment." On the latest Houston We Have a Podcast episode…'
                  url: https://www.facebook.com/NASA/posts/pfbid0MockPermalink
                  permalink: https://www.facebook.com/NASA/posts/pfbid0MockPermalink
                  publishTime: 1783971380
                  author:
                    id: '100044561550831'
                    name: NASA - National Aeronautics and Space Administration
                    short_name: NASA
                    __typename: User
                  reactionCount: 131
                  commentCount: 14
                  shareCount: 11
                  videoViewCount: null
                  videoDetails: null
                  attachments: []
                  topComments: []
                cursor: Cg8Ob3JnYW5pY19jdXJzb3IJmockcursor
                hasNextPage: true
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
  /v1/facebook/post:
    get:
      tags:
      - Facebook
      summary: Get a single Facebook post by URL (message, reactions, comments, shares, video)
      operationId: facebook_v1_post
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: url
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                post:
                  id: '1576597780502259'
                  text: A single mock post from the drop-in fixture.
                  url: https://www.facebook.com/NASA/posts/pfbid0MockPermalink
                  permalink: https://www.facebook.com/NASA/posts/pfbid0MockPermalink
                  publishTime: 1783971380
                  author:
                    id: '100044561550831'
                    name: NASA
                    short_name: NASA
                    __typename: User
                  reactionCount: 131
                  commentCount: 14
                  shareCount: 11
                  videoViewCount: null
                  videoDetails: null
                  attachments: []
                  topComments: []
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
  /v1/facebook/post/comments:
    get:
      tags:
      - Facebook
      summary: Get the comments on a Facebook post by URL (embedded top comments; full list…
      operationId: facebook_v1_post_comments
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: url
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                comments:
                - id: Y29tbWVudDptb2Nr
                  text: A mock comment.
                  publishTime: 1783971500
                  reactionCount: 3
                  author:
                    id: '61550000000000'
                    name: Mock User
                    url: https://www.facebook.com/mock
                cursor: null
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
  /v1/facebook/profile/reels:
    get:
      tags:
      - Facebook
      summary: Get a Facebook page's videos/reels (id, title, thumbnail, play count)
      operationId: facebook_v1_profile_reels
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: url
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: pageId
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: handle
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                reels:
                - id: '1234567890'
                  url: https://www.facebook.com/watch/?v=1234567890
                  title: Mock NASA video
                  thumbnail: https://scontent.fbcdn.net/mock-thumb.jpg
                  publishTime: 1783971380
                  playCount: 1200000
                cursor: null
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
  /v1/facebook/profile/photos:
    get:
      tags:
      - Facebook
      summary: Get a Facebook page's photos (id, image url, link)
      operationId: facebook_v1_profile_photos
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: url
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: pageId
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      - name: handle
        in: query
        required: false
        description: 'Provide at least one of: url, pageId, handle.'
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                photos:
                - id: '9876543210'
                  url: https://www.facebook.com/NASA/photos/9876543210
                  image: https://scontent.fbcdn.net/mock-photo.jpg
                  accessibilityCaption: May be an image of the moon.
                cursor: null
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your scraper-api.com API key.
x-tagGroups:
- name: Platforms
  tags:
  - Instagram
  - TikTok
  - YouTube
  - Facebook
  - LinkedIn
  - Twitter
  - Spotify
  - Apple Music
  - Kleinanzeigen
  - Quoka
  - markt.de
  - mobile.de
  - '11880'
  - Gelbe Seiten
  - ImmobilienScout24
  - immowelt
  - WG-Gesucht
  - Bayut
  - LOVOO
  - Jaumo
  - Tinder
  - Bumble
  - Snapchat
  - Google
  - Arbeitsagentur
  - Ausbildung.de
  - meinestadt.de