Get Page or Profile

curl --request GET \
  --url https://scrapebadger.com/v1/facebook/pages/{identifier} \
  --header 'X-API-Key: <x-api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};

fetch('https://scrapebadger.com/v1/facebook/pages/{identifier}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/facebook/pages/{identifier}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/facebook/pages/{identifier}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/facebook/pages/{identifier}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "name": "<string>",
  "url": "<string>",
  "username": "<string>",
  "type": "<string>",
  "is_verified": true,
  "profile_picture": "<string>",
  "cover_photo": "<string>",
  "category": "<string>",
  "description": "<string>",
  "followers_count": 123,
  "likes_count": 123,
  "friends_count": 123,
  "is_business_page": true,
  "website": "<string>",
  "phone": "<string>",
  "email": "<string>",
  "address": "<string>",
  "rating": 123,
  "rating_count": 123,
  "about": {}
}

GET

facebook

pages

{identifier}

Get Page or Profile

curl --request GET \
  --url https://scrapebadger.com/v1/facebook/pages/{identifier} \
  --header 'X-API-Key: <x-api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};

fetch('https://scrapebadger.com/v1/facebook/pages/{identifier}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/facebook/pages/{identifier}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/facebook/pages/{identifier}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/facebook/pages/{identifier}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "name": "<string>",
  "url": "<string>",
  "username": "<string>",
  "type": "<string>",
  "is_verified": true,
  "profile_picture": "<string>",
  "cover_photo": "<string>",
  "category": "<string>",
  "description": "<string>",
  "followers_count": 123,
  "likes_count": 123,
  "friends_count": 123,
  "is_business_page": true,
  "website": "<string>",
  "phone": "<string>",
  "email": "<string>",
  "address": "<string>",
  "rating": 123,
  "rating_count": 123,
  "about": {}
}

Fetch a Facebook Page or public profile by vanity slug or numeric id. Both endpoints share one Profile model; the type field distinguishes them.

Endpoint	Use for
`GET /v1/facebook/pages/{identifier}`	business / organization Pages
`GET /v1/facebook/profiles/{identifier}`	personal and public profiles

Both fetch the About tile as a second hop, so website, phone, email, address and rating are populated where the entity publishes them. Credits: 5 (each)

Authorization

string

required

Your ScrapeBadger API key.

Path Parameters

string

required

Vanity slug (the facebook.com/<slug> segment, e.g. nasa) or the numeric entity id.

Response

Returns a single Profile object.

string

Numeric entity id.

string

Display name.

string

Canonical facebook.com URL.

string

Vanity slug, when the entity has one.

string

profile or page.

boolean

Blue-check verification.

string

Avatar URL.

string

Cover image URL.

string

Page category, e.g. Government Organization.

string

Bio / Page intro.

integer

Follower count. null when Facebook renders only an abbreviated string or the entity hides it.

integer

Page like count.

integer

Friend count (profiles).

boolean

Whether the entity is a business Page.

string

Website from the About tile.

string

Public phone number.

string

Public email address.

string

Public street address.

number

Average rating, 0–5.

integer

Number of ratings.

object

Remaining raw About-tile key/values that have no first-class field — hours, price range, founding date, mission, awards and other Page-type-specific entries.

Example

curl "https://scrapebadger.com/v1/facebook/pages/nasa" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch("https://scrapebadger.com/v1/facebook/pages/nasa", {
  headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY },
});
const page = await res.json();

import requests

res = requests.get(
    "https://scrapebadger.com/v1/facebook/pages/nasa",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
page = res.json()

Response

{
  "id": "54971236771",
  "name": "NASA",
  "url": "https://www.facebook.com/NASA",
  "username": "NASA",
  "type": "page",
  "is_verified": true,
  "profile_picture": "https://scontent.xx.fbcdn.net/v/t39.30808-1/32118_n.jpg",
  "cover_photo": "https://scontent.xx.fbcdn.net/v/t39.30808-6/91224_n.jpg",
  "category": "Government Organization",
  "description": "Explore the universe and discover our home planet with NASA.",
  "followers_count": 22140883,
  "likes_count": 21876204,
  "friends_count": null,
  "is_business_page": true,
  "website": "http://www.nasa.gov",
  "phone": null,
  "email": null,
  "address": "300 E Street SW, Washington, DC 20546",
  "rating": null,
  "rating_count": null,
  "about": {
    "mission": "To explore the secrets of the universe for the benefit of all.",
    "founded": "July 29, 1958"
  }
}

Personal profiles expose far less than Pages: most fields on a locked-down profile come back null. 404 means the slug or id does not resolve, or the entity is region-restricted.

Facebook API

Endpoints

Get Page or Profile

Authorization

Path Parameters

Response

Example

​Authorization

​Path Parameters

​Response

​Example

Authorization

Path Parameters

Response

Example