Facebook API Tutorial

How to Scrape Facebook Post Details

Get Facebook post details with optional comments and transcript. This guide walks you through the entire process, with copy-paste code examples in Node.js, JavaScript, Python, PHP, Ruby, Java, C#, Go, Rust, TypeScript, Swift, Kotlin, R and cURL.

Overview

What You'll Learn

Setting up your environment
Installing the required HTTP client
Authenticating with SociaVault API
Making requests to Facebook
Handling responses and errors

What You'll Get

Access to post data
JSON formatted responses
Real-time data access
Scalable solution
Error handling patterns

Prerequisites

1. API Key

First, you'll need a SociaVault API key to authenticate your requests.

Get your free API key

2. Development Environment

Make sure you have the following ready:

Your preferred language installed (Python, Node.js, etc.)
A code editor (VS Code, Sublime, etc.)
Command line interface access

Implementation

Pick your language below — the install command and full code example update accordingly.

Step 1: Install the HTTP client (Node.js)

We'll use axios to make HTTP requests in Node.js.

bash

npm install axios

Step 2: Make the request (Node.js)

Here's the full Node.js example. Replace YOUR_API_KEY with your actual API key.

nodejs

import axios from 'axios';

const API_KEY = 'YOUR_API_KEY';

async function scrape() {
  try {
    const response = await axios.get(`https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655`, {
      headers: {
        'x-api-key': API_KEY,
        'Content-Type': 'application/json'
      }
    });

    console.log('Response:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}

// Usage
scrape();

Step 1: Install the HTTP client (JavaScript)

We'll use fetch to make HTTP requests in JavaScript.

bash

# Native fetch API

Step 2: Make the request (JavaScript)

Here's the full JavaScript example. Replace YOUR_API_KEY with your actual API key.

javascript

const API_KEY = 'YOUR_API_KEY';

async function scrape() {
  try {
    const response = await fetch(`https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655`, {
      headers: {
        'x-api-key': API_KEY,
        'Content-Type': 'application/json'
      }
    });
    
    const data = await response.json();
    console.log('Response:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
}

scrape();

Step 1: Install the HTTP client (Python)

We'll use requests to make HTTP requests in Python.

bash

pip install requests

Step 2: Make the request (Python)

Here's the full Python example. Replace YOUR_API_KEY with your actual API key.

python

import requests

api_key = "YOUR_API_KEY"
url = "https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655"

headers = {
    "x-api-key": api_key,
    "Content-Type": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    data = response.json()
    print("Response:", data)
except requests.exceptions.RequestException as e:
    print("Error:", e)

Step 1: Install the HTTP client (PHP)

We'll use curl to make HTTP requests in PHP.

bash

# PHP cURL extension required

Step 2: Make the request (PHP)

Here's the full PHP example. Replace YOUR_API_KEY with your actual API key.

php

<?php
$apiKey = "YOUR_API_KEY";
$url = "https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: $apiKey",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Step 1: Install the HTTP client (Ruby)

We'll use net/http to make HTTP requests in Ruby.

bash

# Standard library

Step 2: Make the request (Ruby)

Here's the full Ruby example. Replace YOUR_API_KEY with your actual API key.

ruby

require 'net/http'
require 'json'

url = URI("https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "YOUR_API_KEY"
request["Content-Type"] = "application/json"

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

Step 1: Install the HTTP client (Java)

We'll use HttpClient to make HTTP requests in Java.

bash

// Java 11+ Standard Library

Step 2: Make the request (Java)

Here's the full Java example. Replace YOUR_API_KEY with your actual API key.

java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Scraper {
    public static void main(String[] args) throws Exception {
        String apiKey = "YOUR_API_KEY";
        String url = "https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("x-api-key", apiKey)
                .header("Content-Type", "application/json")
                .GET()
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Step 1: Install the HTTP client (C#)

We'll use HttpClient to make HTTP requests in C#.

bash

// .NET Standard Library

Step 2: Make the request (C#)

Here's the full C# example. Replace YOUR_API_KEY with your actual API key.

csharp

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
        
        var response = await client.GetAsync("https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655");
        var content = await response.Content.ReadAsStringAsync();
        
        Console.WriteLine(content);
    }
}

Step 1: Install the HTTP client (Go)

We'll use net/http to make HTTP requests in Go.

bash

// Standard library

Step 2: Make the request (Go)

Here's the full Go example. Replace YOUR_API_KEY with your actual API key.

package main

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

func main() {
	url := "https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("x-api-key", "YOUR_API_KEY")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(string(body))
}

Step 1: Install the HTTP client (Rust)

We'll use reqwest to make HTTP requests in Rust.

bash

cargo add reqwest tokio

Step 2: Make the request (Rust)

Here's the full Rust example. Replace YOUR_API_KEY with your actual API key.

rust

use reqwest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    let resp = client.get("https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655")
        .header("x-api-key", "YOUR_API_KEY")
        .header("Content-Type", "application/json")
        .send()
        .await?
        .text()
        .await?;

    println!("{}", resp);
    Ok(())
}

Step 1: Install the HTTP client (TypeScript)

We'll use axios to make HTTP requests in TypeScript.

bash

npm install axios

Step 2: Make the request (TypeScript)

Here's the full TypeScript example. Replace YOUR_API_KEY with your actual API key.

typescript

import axios from 'axios';

const API_KEY: string = 'YOUR_API_KEY';

interface ResponseData {
  [key: string]: any;
}

async function scrape(): Promise<ResponseData | void> {
  try {
    const response = await axios.get<ResponseData>(`https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655`, {
      headers: {
        'x-api-key': API_KEY,
        'Content-Type': 'application/json'
      }
    });

    console.log('Response:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error:', error);
  }
}

scrape();

Step 1: Install the HTTP client (Swift)

We'll use URLSession to make HTTP requests in Swift.

bash

// Standard library

Step 2: Make the request (Swift)

Here's the full Swift example. Replace YOUR_API_KEY with your actual API key.

swift

import Foundation

let url = URL(string: "https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "x-api-key")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        if let json = try? JSONSerialization.jsonObject(with: data, options: []) {
            print(json)
        }
    }
}

task.resume()

Step 1: Install the HTTP client (Kotlin)

We'll use OkHttp to make HTTP requests in Kotlin.

bash

implementation("com.squareup.okhttp3:okhttp:4.10.0")

Step 2: Make the request (Kotlin)

Here's the full Kotlin example. Replace YOUR_API_KEY with your actual API key.

kotlin

import okhttp3.OkHttpClient
import okhttp3.Request

fun main() {
    val client = OkHttpClient()
    val request = Request.Builder()
        .url("https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655")
        .addHeader("x-api-key", "YOUR_API_KEY")
        .addHeader("Content-Type", "application/json")
        .build()

    client.newCall(request).execute().use { response ->
        println(response.body?.string())
    }
}

Step 1: Install the HTTP client (R)

We'll use httr to make HTTP requests in R.

bash

install.packages('httr')

Step 2: Make the request (R)

Here's the full R example. Replace YOUR_API_KEY with your actual API key.

library(httr)

url <- "https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655"
response <- GET(url, add_headers("x-api-key" = "YOUR_API_KEY", "Content-Type" = "application/json"))

content(response, "text")

Step 1: Install the HTTP client (cURL)

We'll use curl to make HTTP requests in cURL.

bash

# No installation required on most systems

Step 2: Make the request (cURL)

Here's the full cURL example. Replace YOUR_API_KEY with your actual API key.

curl

curl -X GET "https://api.sociavault.com/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Testing Your Code

API Parameters

Parameter	Type	Required	Description
url	string	Yes	Example: `https://www.facebook.com/reel/1535656380759655`

Expected Response

You should receive a structured JSON response containing the post data.

json

{
  "success": true,
  "credits_remaining": 48026,
  "post_id": "25118307061088489",
  "like_count": 2095,
  "comment_count": 48,
  "share_count": 133,
  "view_count": 133000,
  "description": "Air Fryer Chocolate Cake \n\n100% f*cks, super simple and comes out gooey in the middle. 🍆 \n\n👨‍🍳 Ingredients:\n✅ 1 large banana – 100 g (3.5 oz)\n✅ 80 g vanilla YoPro yogurt (2.8 oz / ⅓ cup)\n✅ 15 g Cadbury Bournville cocoa (0.5 oz / 1 tbsp)\n✅ 80 ml egg whites (2.7 fl oz / ⅓ cup)\n✅ 50 g oat flour (1.75 oz / ½ cup)\n✅ 1 tsp vanilla extract (5 ml)\n✅ ½ tsp baking powder (2.5 g)\n👉 Optional: 1 square dark chocolate (10 g / 0.35 oz, ~55 cals)\n\n🔥 Method:\n 1. Mix banana, egg whites, yogurt, cocoa and vanilla until smooth\n 2. Stir in oat flour and baking powder\n 3. Pour into a ramekin or muffin tin\n 4. Add chocolate square to the centre if using\n 5. Air fry at 160°C / 320°F for 20 minutes\n\n📊 Macros (whole recipe):\nWithout choc: 378 cals | 27 g protein | 61.9 g carbs | 6 g fat\nWith choc: 433 cals | 27 g protein | 61.9 g carbs | 11.5 g fat\n\n📊 Macros (per serve — 2 serves):\nWithout choc: 189 cals | 13.5g protein | 31 g carbs | 3 g fat\nWith choc: 217 cals | 13.5 g protein | 31 g carbs | 5.8 g fat\n\nI also added low-calorie Peters ice cream and a small drizzle of Biscoff, but it honestly doesn’t need it. Tastes great on its own!\n\nIf you would like to make changes to this recipe yourself please do, but I like this EXACTLY the way it is. 🤝🫡",
  "feedback_id": "ZmVlZGJhY2s6MjUxMDIxMDY3OTkzNzUxODI=",
  "url": "https://www.facebook.com/reel/1535656380759655",
  "video": {
    "id": "1535656380759655",
    "sd_url": "https://video-fml1-1.xx.fbcdn.net/o1/v/t2/f2/m69/AQPmP0-_mHv5cFqZShaBXjVeIgFmk-_1-6fll0qvoiw3O_StvDRD1FPZafKE0Mri9p94smEKiXpdPjrMnIk2qesQ.mp4?strext=1&_nc_cat=106&_nc_sid=8bf8fe&_nc_ht=video-fml1-1.xx.fbcdn.net&_nc_ohc=l9xG1fq_DpcQ7kNvwHsNBKh&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl8zNjBwIiwieHB2X2Fzc2V0X2lkIjo4MTEzOTQ4MTQ3NDY5NjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoyMywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pXV0rbdIO2qXvelwzem88A&_nc_zt=28&oh=00_AfYY-br7Wa1JiPzs7_0vVr6SEV6zDf7qREmd6IV2xBGYMA&oe=68D239F0&bitrate=313736&tag=progressive_h264-basic-gen2_360p",
    "hd_url": "https://video-fml1-1.xx.fbcdn.net/o1/v/t2/f2/m69/AQPvY-B_jtS_HwdB--AaOLTiMpw_euZ4QZoJbbh4iBl-faYyL6mYoumXJPqDF8qAnvZk8_SN5QOUds3tDfP0Bfa0.mp4?strext=1&_nc_cat=109&_nc_sid=8bf8fe&_nc_ht=video-fml1-1.xx.fbcdn.net&_nc_ohc=Z4s5wsMtW5wQ7kNvwFE0mwo&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjo4MTEzOTQ4MTQ3NDY5NjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoyMywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pXV0rbdIO2qXvelwzem88A&_nc_zt=28&oh=00_AfZJDoPCKtq3WW2VumFViHPpmIkGGqG34j9MWd9FmGrCVg&oe=68D25899&bitrate=1088662&tag=progressive_h264-basic-gen2_720p",
    "height": 1920,
    "width": 1080,
    "length_in_second": 23.36,
    "thumbnail": "https://scontent-fml1-1.xx.fbcdn.net/v/t51.82787-10/549761436_18521992156021539_7633323777597918486_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=282d23&_nc_ohc=1LkTvLqxMhAQ7kNvwF2uUb7&_nc_oc=AdlKRAdNOj6ZDiga-3Zfj5bcwvfc68Lc39nsYJQ0hSPWGsRtUZJZ_sPCk25DrZJ2N98&_nc_zt=23&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfZy5UXtBdlEMJc6E6uLLiTvR15d344Nn4PO-wNA0cldQQ&oe=68D25528",
    "captions_url": "https://scontent-fml1-1.xx.fbcdn.net/v/t39.2093-6/548496336_1535656704092956_4849526113470105591_n.srt?_nc_cat=105&ccb=1-7&_nc_sid=c211c2&_nc_ohc=IiEVsW2fSK0Q7kNvwEeCqpW&_nc_oc=AdmC4PNaIEGYuNZo_Qk6Qha6U8-ynQip-CKdvOrtQBRqTCrO8nOb6C5kABxPkLO4Vdc&_nc_zt=14&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfaJjBR2lJhhXTUO5hl0FWPGIlLxjVfuGMmTKUWSEtf6xA&oe=68D23D9F"
  },
  "author": {
    "id": "100000076236457",
    "name": "Matt West",
    "is_verified": true,
    "url": "https://www.facebook.com/matt.west.184",
    "image": "https://scontent-fml1-1.xx.fbcdn.net/v/t39.30808-1/485744182_9938984382780671_4072259528431711152_n.jpg?stp=cp0_dst-jpg_s40x40_tt6&_nc_cat=1&ccb=1-7&_nc_sid=1d2534&_nc_ohc=zu8xeHB9r5gQ7kNvwGWw84m&_nc_oc=AdkZ2Ef1ReB34aXLnnIpd4KHQ95nC0wAYS1GptVwcltvxMBjKXEU_D-mebY8WPwkhGI&_nc_zt=24&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfbFDYlovggVMiDAQp2_r7Ou-o0RG4T0VPbLMxVTfPlW7g&oe=68D250E6"
  },
  "music": {
    "id": "1506592770696336",
    "type": "CUSTOM_AUDIO",
    "track_title": "Matt West · Original audio",
    "music_album_art": "https://scontent-fml1-1.xx.fbcdn.net/v/t39.30808-1/485744182_9938984382780671_4072259528431711152_n.jpg?stp=cp0_dst-jpg_s64x64_tt6&_nc_cat=1&ccb=1-7&_nc_sid=1d2534&_nc_ohc=zu8xeHB9r5gQ7kNvwGWw84m&_nc_oc=AdkZ2Ef1ReB34aXLnnIpd4KHQ95nC0wAYS1GptVwcltvxMBjKXEU_D-mebY8WPwkhGI&_nc_zt=24&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfZEGmsJmX51XXJTwXi90sPYazNybtjik0KhIFczr3jqIg&oe=68D250E6"
  }
}

Best Practices

Error Handling

Implement comprehensive error handling and retry logic for failed requests. Log errors properly for debugging.

Caching

Cache responses when possible to reduce API calls and improve performance. Consider data freshness requirements.

Security

Never expose your API key in client-side code. Use environment variables and secure key management practices.

Troubleshooting

401

Unauthorized

Check your API key is correct and properly formatted in the x-api-key header.

402

Payment Required

You ran out of credits and need to buy more.

404

Not Found

The resource (user, video, etc.) might not exist or be private.

429

Too Many Requests

You have exceeded your rate limit. Slow down your requests.

Frequently Asked Questions

How much does it cost to scrape Facebook?

SociaVault offers 50 free API calls to get started. After that, pricing starts at $10 for 5k requests with volume discounts available.

Is it legal to scrape Facebook data?

Scraping publicly available data is generally considered legal. We only collect public data that is accessible without logging in.

Which programming languages can I use to scrape Facebook?

Any language that can make an HTTP request. This tutorial includes ready-to-use examples in Node.js, JavaScript, Python, PHP, Ruby, Java, C#, Go, Rust, TypeScript, Swift, Kotlin, R, cURL.

What data format does the API return?

All API responses are returned in JSON format, making it easy to integrate with any programming language or application.

Start Scraping Free View Documentation

Overview

What You'll Learn

What You'll Get

Prerequisites

1. API Key

2. Development Environment

Implementation

Step 1: Install the HTTP client (Node.js)

Step 2: Make the request (Node.js)

Step 1: Install the HTTP client (JavaScript)

Step 2: Make the request (JavaScript)

Step 1: Install the HTTP client (Python)

Step 2: Make the request (Python)

Step 1: Install the HTTP client (PHP)

Step 2: Make the request (PHP)

Step 1: Install the HTTP client (Ruby)

Step 2: Make the request (Ruby)

Step 1: Install the HTTP client (Java)

Step 2: Make the request (Java)

Step 1: Install the HTTP client (C#)

Step 2: Make the request (C#)

Step 1: Install the HTTP client (Go)

Step 2: Make the request (Go)

Step 1: Install the HTTP client (Rust)

Step 2: Make the request (Rust)

Step 1: Install the HTTP client (TypeScript)

Step 2: Make the request (TypeScript)

Step 1: Install the HTTP client (Swift)

Step 2: Make the request (Swift)

Step 1: Install the HTTP client (Kotlin)

Step 2: Make the request (Kotlin)

Step 1: Install the HTTP client (R)

Step 2: Make the request (R)

Step 1: Install the HTTP client (cURL)

Step 2: Make the request (cURL)

Testing Your Code

API Parameters

Expected Response

Best Practices

Error Handling

Caching

Security

Troubleshooting

Unauthorized

Payment Required

Not Found

Too Many Requests

Frequently Asked Questions

How much does it cost to scrape Facebook?

Is it legal to scrape Facebook data?

Which programming languages can I use to scrape Facebook?

What data format does the API return?

Related Tutorials

More Facebook Tutorials

Other Platforms

Ready to Start Scraping?