facebook_data_max

🚀 Facebook Data API Documentation

Welcome to the Facebook Data API! This document provides detailed information on how to interact with our API endpoints to retrieve valuable page data from Facebook. All requests are authenticated using headers provided by RapidAPI.

🔑 Authentication

Authentication is required for all API endpoints. You must include the following headers in every request:

Header	Type	Required	Description
x-rapidapi-key	string	✅ Yes	Your personal key from your RapidAPI subscription.
x-rapidapi-host	string	✅ Yes	The API host: `facebook-data-max.p.rapidapi.com`

🏢 1. Search for Facebook Pages

This endpoint allows you to search for Facebook Pages using a variety of filters. It supports pagination.

Method & Path: POST /api/facebook/homes/search/

▶️ Request Body

Parameter	Type	Required	Description
search_word	string	✅ Yes	The primary keyword to search for pages (e.g., "ikea", "restaurant"). This parameter is always required.
domain_name	string	❌ No	Filter results by the company's domain name (e.g., "ikea.com"). Cannot be used if `address` or `country_code` are provided.
address	string	❌ No	Filter results by a specific address or location. Cannot be used if `domain_name` is provided.
country_code	string	❌ No	Filter results by a two-letter ISO 3166-1 alpha-2 country code (e.g., "SE", "US"). Cannot be used if `domain_name` is provided.
page_number	integer	❌ No	The page number for pagination. Defaults to 1.
page_size	integer	❌ No	The number of results per page. Defaults to 10.

✅ Success Response (200 OK)

{
"code": "integer",
"result": {
"search_word": "string | null",
"country_code": "string | null",
"address": "string | null",
"domain_first_name": "string | null",
"total": "integer",
"count": "integer",
"page_number": "integer",
"page_size": "integer",
"data": [
{
"user_name": "string",
"name": "string",
"category_names": ["string"],
"country_code": "string",
"country_name": "string",
"address": "string",
"description": "string",
"followers_total": "integer",
"url": "string (url)",
"phone_numbers": ["string"],
"email_addresses": ["string"],
"website_urls": ["string (url)"]
}
]
},
"message": "string"
}

🖼️ 2. Get Page Picture

This endpoint retrieves the profile picture URL for a specific Facebook Page by providing its unique `user_name`.

Method & Path: POST /api/facebook/home/picture/

▶️ Request Body

Parameter	Type	Required	Description
unique_id	string	✅ Yes	The unique identifier for the Facebook Page (i.e., the `user_name` obtained from the search results).

✅ Success Response (200 OK)

{
"code": "integer",
"result": {
"data": {
"url": "string (url)"
}
},
"message": "string"
}

ℹ️ 3. Get Page Details

This endpoint retrieves detailed information for a single Facebook Page by providing its full URL.

Method & Path: POST /api/facebook/home/

▶️ Request Body

Parameter	Type	Required	Description
url	string	✅ Yes	The full URL of the Facebook Page (e.g., `https://www.facebook.com/ikea` or `https://facebook.com/100064241340253`).

✅ Success Response (200 OK)

{
"code": "integer",
"result": {
"url": "string",
"data": {
"user_name": "string",
"name": "string",
"category_names": ["string"],
"country_code": "string",
"country_name": "string",
"address": "string",
"description": "string",
"followers_total": "integer",
"url": "string (url)",
"phone_numbers": ["string"],
"email_addresses": ["string"],
"website_urls": ["string (url)"]
}
},
"message": "string"
}