Try it instantly

See real data shapes from every endpoint — no signup required.

Request

GET /facebook/page

page_id cocacola required

country us

curl -G "https://api.pullapi.com/facebook/page" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "page_id": "40796308305",
    "username": "cocacola",
    "name": "Coca-Cola",
    "category": "Food & Beverage Company",
    "subcategories": [ "Drink", "Brand"
    ],
    "description": "The Coca-Cola Facebook Page is a collection of your stories showing how people from around the world have helped make Coke what it is today.",
    "follower_count": 109483210,
    "like_count": 107562384,
    "rating": 4.3,
    "review_count": 18420,
    "phone": null,
    "email": null,
    "website": "https://www.coca-cola.com",
    "address": "One Coca-Cola Plaza",
    "city": "Atlanta",
    "state": "GA",
    "zip_code": "30313",
    "country": "US",
    "hours": [
      {
        "day": "Monday",
        "open": "09: 00",
        "close": "17: 00"
      },
      {
        "day": "Tuesday",
        "open": "09: 00",
        "close": "17: 00"
      }
    ],
    "price_range": null,
    "profile_pic_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/example.jpg",
    "cover_photo_url": "https://scontent.xx.fbcdn.net/v/t39.30808-6/example.jpg",
    "is_verified": true,
    "page_url": "https://www.facebook.com/cocacola"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Request

GET /facebook/profile

username zuck required

country us

curl -G "https://api.pullapi.com/facebook/profile" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "profile_id": "4",
    "username": "zuck",
    "name": "Mark Zuckerberg",
    "bio": "Building things that bring people together.",
    "follower_count": 120543891,
    "following_count": 452,
    "profile_pic_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/example_profile.jpg",
    "cover_photo_url": "https://scontent.xx.fbcdn.net/v/t39.30808-6/example_cover.jpg",
    "work": [ "Meta"
    ],
    "education": [ "Harvard University"
    ],
    "location": "Palo Alto, California",
    "is_verified": true,
    "profile_url": "https://www.facebook.com/zuck"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Request

GET /facebook/posts

page_id cocacola required

limit 10

country us

curl -G "https://api.pullapi.com/facebook/posts" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "page_name": "Coca-Cola",
    "username": "cocacola",
    "posts": [
      {
        "post_id": "10160754567308306",
        "text": "Nothing beats the real thing. What's your favorite way to enjoy a Coke? #CocaCola",
        "timestamp": "2026-03-14T18: 30: 00+00: 00",
        "reaction_count": 24530,
        "comment_count": 1842,
        "share_count": 567,
        "media_urls": [ "https://scontent.xx.fbcdn.net/v/t39.30808-6/example_post.jpg"
        ],
        "media_type": "photo",
        "link_url": null,
        "post_url": "https://www.facebook.com/cocacola/posts/10160754567308306"
      },
      {
        "post_id": "10160751234508306",
        "text": "Check out our new limited edition flavors, available now!",
        "timestamp": "2026-03-12T14: 00: 00+00: 00",
        "reaction_count": 18200,
        "comment_count": 932,
        "share_count": 312,
        "media_urls": [],
        "media_type": "link",
        "link_url": "https://www.coca-cola.com/new-flavors",
        "post_url": "https://www.facebook.com/cocacola/posts/10160751234508306"
      }
    ],
    "post_count": 2
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Request

GET /facebook/marketplace

query iPhone 15 required

location Los Angeles, CA

limit 20

country us

curl -G "https://api.pullapi.com/facebook/marketplace" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "query": "iPhone 15",
    "location": "Los Angeles, CA",
    "listings": [
      {
        "listing_id": "1234567890123456",
        "title": "iPhone 15 Pro Max 256GB - Like New",
        "price": "$850",
        "location": "Los Angeles, CA",
        "image_url": "https://scontent.xx.fbcdn.net/v/t45.5328-4/example_listing.jpg",
        "listing_url": "https://www.facebook.com/marketplace/item/1234567890123456",
        "seller_name": "John D."
      },
      {
        "listing_id": "9876543210987654",
        "title": "iPhone 15 128GB Blue - Excellent Condition",
        "price": "$620",
        "location": "Santa Monica, CA",
        "image_url": "https://scontent.xx.fbcdn.net/v/t45.5328-4/example_listing2.jpg",
        "listing_url": "https://www.facebook.com/marketplace/item/9876543210987654",
        "seller_name": "Sarah M."
      }
    ],
    "listing_count": 2
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

API Endpoints

4 endpoints across 4 categories.

Page

GET /facebook/page Get Page Details

Get full details for a Facebook page including name, category, description, follower/like counts, rating, contact info, address, hours, and verification status. Accepts a page slug, numeric page ID, or full Facebook URL.

Parameters

Name	Type	Required	Description	Example
`page_id`	string	Yes	Facebook page ID, slug, or URL. Examples: "cocacola", "123456789", "https://facebook.com/cocacola"	cocacola
`country`	string	No	Country code for proxy geo-targeting (ISO 3166-1 alpha-2). Affects which regional version of the...	us

Example Response

{
  "success": true,
  "data": {
    "page_id": "40796308305",
    "username": "cocacola",
    "name": "Coca-Cola",
    "category": "Food & Beverage Company",
    "subcategories": [ "Drink", "Brand"
    ],
    "description": "The Coca-Cola Facebook Page is a collection of your stories showing how people from around the world have helped make Coke what it is today.",
    "follower_count": 109483210,
    "like_count": 107562384,
    "rating": 4.3,
    "review_count": 18420,
    "phone": null,
    "email": null,
    "website": "https://www.coca-cola.com",
    "address": "One Coca-Cola Plaza",
    "city": "Atlanta",
    "state": "GA",
    "zip_code": "30313",
    "country": "US",
    "hours": [
      {
        "day": "Monday",
        "open": "09: 00",
        "close": "17: 00"
      },
      {
        "day": "Tuesday",
        "open": "09: 00",
        "close": "17: 00"
      }
    ],
    "price_range": null,
    "profile_pic_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/example.jpg",
    "cover_photo_url": "https://scontent.xx.fbcdn.net/v/t39.30808-6/example.jpg",
    "is_verified": true,
    "page_url": "https://www.facebook.com/cocacola"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Profile

GET /facebook/profile Get User Profile

Get a Facebook user's public profile including name, bio, follower/following counts, work and education history, location, and verification status. Accepts a username or profile URL.

Parameters

Name	Type	Required	Description	Example
`username`	string	Yes	Facebook username or profile URL. Examples: "zuck", "https://facebook.com/zuck"	zuck
`country`	string	No	Country code for proxy geo-targeting (ISO 3166-1 alpha-2)	us

Example Response

{
  "success": true,
  "data": {
    "profile_id": "4",
    "username": "zuck",
    "name": "Mark Zuckerberg",
    "bio": "Building things that bring people together.",
    "follower_count": 120543891,
    "following_count": 452,
    "profile_pic_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/example_profile.jpg",
    "cover_photo_url": "https://scontent.xx.fbcdn.net/v/t39.30808-6/example_cover.jpg",
    "work": [ "Meta"
    ],
    "education": [ "Harvard University"
    ],
    "location": "Palo Alto, California",
    "is_verified": true,
    "profile_url": "https://www.facebook.com/zuck"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Posts

GET /facebook/posts Get Page Posts

Get recent posts from a Facebook page including post text, timestamps, reaction/comment/share counts, and attached media URLs. Returns up to 20 posts per request.

Parameters

Name	Type	Required	Description	Example
`page_id`	string	Yes	Facebook page ID, slug, or URL. Examples: "cocacola", "123456789", "https://facebook.com/cocacola"	cocacola
`limit`	integer	No	Number of posts to return (1-20)	10
`country`	string	No	Country code for proxy geo-targeting (ISO 3166-1 alpha-2)	us

Example Response

{
  "success": true,
  "data": {
    "page_name": "Coca-Cola",
    "username": "cocacola",
    "posts": [
      {
        "post_id": "10160754567308306",
        "text": "Nothing beats the real thing. What's your favorite way to enjoy a Coke? #CocaCola",
        "timestamp": "2026-03-14T18: 30: 00+00: 00",
        "reaction_count": 24530,
        "comment_count": 1842,
        "share_count": 567,
        "media_urls": [ "https://scontent.xx.fbcdn.net/v/t39.30808-6/example_post.jpg"
        ],
        "media_type": "photo",
        "link_url": null,
        "post_url": "https://www.facebook.com/cocacola/posts/10160754567308306"
      },
      {
        "post_id": "10160751234508306",
        "text": "Check out our new limited edition flavors, available now!",
        "timestamp": "2026-03-12T14: 00: 00+00: 00",
        "reaction_count": 18200,
        "comment_count": 932,
        "share_count": 312,
        "media_urls": [],
        "media_type": "link",
        "link_url": "https://www.coca-cola.com/new-flavors",
        "post_url": "https://www.facebook.com/cocacola/posts/10160751234508306"
      }
    ],
    "post_count": 2
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Marketplace

GET /facebook/marketplace Search Marketplace Listings

Search Facebook Marketplace listings by keyword with optional location filtering. Returns listing titles, prices, locations, images, and seller names. Up to 50 listings per request.

Parameters

Name	Type	Required	Description	Example
`query`	string	Yes	Search query for marketplace listings. Examples: "iPhone 15", "used car", "furniture"	iPhone 15
`location`	string	No	Location to search near (city, state, etc.). When omitted, defaults to a general search....	Los Angeles, CA
`limit`	integer	No	Number of listings to return (1-50)	20
`country`	string	No	Country code for proxy geo-targeting (ISO 3166-1 alpha-2)	us

Example Response

{
  "success": true,
  "data": {
    "query": "iPhone 15",
    "location": "Los Angeles, CA",
    "listings": [
      {
        "listing_id": "1234567890123456",
        "title": "iPhone 15 Pro Max 256GB - Like New",
        "price": "$850",
        "location": "Los Angeles, CA",
        "image_url": "https://scontent.xx.fbcdn.net/v/t45.5328-4/example_listing.jpg",
        "listing_url": "https://www.facebook.com/marketplace/item/1234567890123456",
        "seller_name": "John D."
      },
      {
        "listing_id": "9876543210987654",
        "title": "iPhone 15 128GB Blue - Excellent Condition",
        "price": "$620",
        "location": "Santa Monica, CA",
        "image_url": "https://scontent.xx.fbcdn.net/v/t45.5328-4/example_listing2.jpg",
        "listing_url": "https://www.facebook.com/marketplace/item/9876543210987654",
        "seller_name": "Sarah M."
      }
    ],
    "listing_count": 2
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Code Examples

Get started in seconds with your preferred language.

Terminal

curl -G "https://api.pullapi.com/facebook/page?page_id=cocacola&country=us" \
  -H "x-rapidapi-host: facebook-scraper-api.p.rapidapi.com" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Python

import requests

url = "https://api.pullapi.com/facebook/page"
headers = {
    "x-rapidapi-host": "facebook-scraper-api.p.rapidapi.com",
    "x-rapidapi-key": "YOUR_API_KEY"
}
params = {
    "page_id": "cocacola",
    "country": "us",
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

JavaScript

const response = await fetch(
  "https://api.pullapi.com/facebook/page?page_id=cocacola&country=us",
  {
    headers: {
      "x-rapidapi-host": "facebook-scraper-api.p.rapidapi.com",
      "x-rapidapi-key": "YOUR_API_KEY"
    }
  }
);
const data = await response.json();
console.log(data);

Why PullAPI

</>

No Browser Needed

HTTP-based API. No Selenium, no Puppeteer, no headless browsers to manage.

⇄

Built-in Proxy Rotation

Automatic residential proxy rotation handles anti-bot detection for you.

⚡

Cached Responses

Smart Redis caching means faster repeated queries and lower costs.

$

Pay Per Request

No monthly commitment. Free tier included. Pay only for what you use.

Use Cases

What developers build with the Facebook Scraper API.

1

Page Analytics

2

Marketplace Monitoring

3

Content Tracking

4

Audience Research

Related Scrapers

More APIs in Social Media.

Instagram Scraper

Influencer Analytics · Content Monitoring

TikTok Scraper

Creator Analytics · Trend Tracking

YouTube Scraper

Channel Analytics · Video Research

Reddit Scraper

Sentiment Analysis · Trend Detection

Twitter/X Scraper

Sentiment Analysis · Influencer Monitoring

Twitch Scraper

Streamer Analytics · Content Discovery

Facebook Scraper API

Try it instantly

API Endpoints

Page

Parameters

Example Response

Profile

Parameters

Example Response

Posts

Parameters

Example Response

Marketplace

Parameters

Example Response

Code Examples

Why PullAPI

No Browser Needed

Built-in Proxy Rotation

Cached Responses

Pay Per Request

Use Cases

Page Analytics

Marketplace Monitoring

Content Tracking

Audience Research

Related Scrapers

Instagram Scraper

TikTok Scraper

YouTube Scraper

Reddit Scraper

Twitter/X Scraper

Twitch Scraper

Ready to scrape Facebook data?