Facebook Profile Posts API

Returns a public Facebook Page's or person's posts, newest first, a page at a time, from its name, ID or link. Each post has its text with hashtags and mentions, its photos, album, video or reel, its link card or the post it shares, its publish time, and exact reaction, comment and share counts with the reactions by type, plus a video's views and the author's name, picture and badge. since and until set a time window Facebook applies itself.

GET /v1/facebook/posts

Read the API reference

1 credit per page, $0.75–$1.97 per 1,000 pages
22 typed fields null when unknown
3 posts per page, newest first
handle is all it needs, e.g. NASA

Send one request. Get up to 3 posts back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap

handle = NASA

Open in playground

GET /v1/facebook/postsTry in

const params = new URLSearchParams({
  handle: "NASA",
});
const res = await fetch(`https://socialtap.dev/v1/facebook/posts?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/facebook/posts",
    params={"handle": "NASA"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/facebook/posts")
uri.query = URI.encode_www_form('handle' => 'NASA')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'handle' => 'NASA',
]);
$ch = curl_init('https://socialtap.dev/v1/facebook/posts?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("handle", "NASA")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/facebook/posts?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl 'https://socialtap.dev/v1/facebook/posts?handle=NASA' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": [
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=cp0_dst-png&cstp=mx800x800&ctp=s80x80&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_nc_ss=7b…",
        "display_name": "NASA - National Aeronautics and Space Administration",
        "id": "100044561550831",
        "is_verified": true,
        "url": "https://www.facebook.com/NASA",
        "username": "NASA"
      },
      "coauthors": [],
      "duration_ms": null,
      "hashtags": [],
      "id": "1676179567210746",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [],
      "mentions": [],
      "metrics": {
        "comment_count": 3,
        "like_count": 64,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": 1,
        "view_count": null
      },
      "platform": "facebook",
      "platform_specific": {
        "facebook": {
          "feedback_id": "ZmVlZGJhY2s6cGZiaWQwMmlSQkFpeENQd1R1Zml6aUFWTXZRdWEzTEJuZHk2dGYzUHl2NDE1UWtaZjdGdjdneTM1U2VpRVltN3Z0UGNMcGps",
          "group": null,
          "is_attachment_unavailable": false,
          "link": null,
          "listing": null,
          "music": null,
          "reactions": [
            {
              "count": 60,
              "type": "like"
            },
            {
              "count": 2,
              "type": "love"
            },
            {
              "count": 1,
              "type": "care"
            }
          ],
          "shared_post": {
            "author": {
              "avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/516872204_1189959146491994_4245240435554141606_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx2048x2047&ctp=s80x80&_nc_cat=103&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&…",
              "display_name": "Learn With NASA",
              "id": "100064337605401",
              "is_verified": true,
              "url": "https://www.facebook.com/LearnWithNASA",
              "username": "LearnWithNASA"
            },
            "id": "1615866537234584",
            "url": "https://www.facebook.com/LearnWithNASA/posts/pfbid0qRf3ZGacva8hj6xVFVrBA29EF3mMnZGmcG6zYUaeLRB1yHARL2KHoPFaqH5jM72yl"
          },
          "video_id": null
        }
      },
      "platform_type": "post",
      "published_at": "2026-11-03T19:27:52Z",
      "text": null,
      "thumbnail_url": null,
      "title": null,
      "type": "text",
      "unknown_fields": [],
      "url": "https://www.facebook.com/NASA/posts/pfbid02iRBAixCPwTufiziAVMvQua3LBndy6tf3Pyv415QkZf7Fv7gy35SeiEYm7vtPcLpjl"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=cp0_dst-png&cstp=mx800x800&ctp=s80x80&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_nc_ss=7b…",
        "display_name": "NASA - National Aeronautics and Space Administration",
        "id": "100044561550831",
        "is_verified": true,
        "url": "https://www.facebook.com/NASA",
        "username": "NASA"
      },
      "coauthors": [],
      "duration_ms": null,
      "hashtags": [],
      "id": "1675983783896991",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": "An intricate cloud of white dust takes center stage in this photo, rising in a windy pillar. The background features rust-colored dust with dots of distant stars and galaxies shining through.",
          "duration_ms": null,
          "expires_at": "2026-10-25T18:00:00Z",
          "height": 1385,
          "thumbnail_url": null,
          "type": "image",
          "url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/871223884_1487536193225483_3660942795677810580_n.png?stp=dst-jpg_tt6&cstp=mx2000x1385&ctp=s2000x1385&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_n…",
          "width": 2000
        }
      ],
      "mentions": [
        "NASAWebb"
      ],
      "metrics": {
        "comment_count": 58,
        "like_count": 2431,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": 185,
        "view_count": null
      },
      "platform": "facebook",
      "platform_specific": {
        "facebook": {
          "feedback_id": "ZmVlZGJhY2s6cGZiaWQwZDJ3bUtXZm9Lc1Q5d0s5bndvV1c1SHpzRWd2MjhjSno5UTZuUDVBMjZCTGNrdVFlQWJCWnNQM0RuSm1pU2s3Q2w=",
          "group": null,
          "is_attachment_unavailable": false,
          "link": null,
          "listing": null,
          "music": null,
          "reactions": [
            {
              "count": 1657,
              "type": "like"
            },
            {
              "count": 687,
              "type": "love"
            },
            {
              "count": 42,
              "type": "care"
            }
          ],
          "shared_post": null,
          "video_id": null
        }
      },
      "platform_type": "post",
      "published_at": "2026-11-03T15:00:35Z",
      "text": "Pspsps 🐈‍⬛\n\nThis smoky specter is the Cat’s Head Nebula, captured in intricate detail by NASA's James Webb Space Telescope. Its name comes from its shape, which resembles a cosmic kitty sitting with its back toward the viewer. What do you see?",
      "thumbnail_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/871223884_1487536193225483_3660942795677810580_n.png?stp=dst-jpg_tt6&cstp=mx2000x1385&ctp=s2000x1385&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_n…",
      "title": null,
      "type": "image",
      "unknown_fields": [],
      "url": "https://www.facebook.com/NASA/posts/pfbid0d2wmKWfoKsT9wK9nwoWW5HzsEgv28cJz9Q6nP5A26BLckuQeAbBZsP3DnJmiSk7Cl"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=cp0_dst-png&cstp=mx800x800&ctp=s80x80&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_nc_ss=7b…",
        "display_name": "NASA - National Aeronautics and Space Administration",
        "id": "100044561550831",
        "is_verified": true,
        "url": "https://www.facebook.com/NASA",
        "username": "NASA"
      },
      "coauthors": [],
      "duration_ms": null,
      "hashtags": [],
      "id": "1675279183967451",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": "An image that shows the \"MAX POWER Kennedy Space Center\" app as it appears in the iOS App Store.",
          "duration_ms": null,
          "expires_at": "2026-10-25T18:00:00Z",
          "height": 1294,
          "thumbnail_url": null,
          "type": "image",
          "url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/864280748_2020097565352172_6759494451320615303_n.png?stp=dst-jpg_tt6&cstp=mx2048x1294&ctp=s2048x1294&_nc_cat=111&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&…",
          "width": 2048
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": 18,
        "like_count": 248,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": 29,
        "view_count": null
      },
      "platform": "facebook",
      "platform_specific": {
        "facebook": {
          "feedback_id": "ZmVlZGJhY2s6cGZiaWQwMnBqYUxiZmhBbkZtckRvb254eDdHeWVwVDFIN3BGYmk5d3JwcXF1TDZvTTVnVFVKYmZCRTJCVDJYY2h0RzkzcjJs",
          "group": null,
          "is_attachment_unavailable": false,
          "link": null,
          "listing": null,
          "music": null,
          "reactions": [
            {
              "count": 215,
              "type": "like"
            },
            {
              "count": 25,
              "type": "love"
            },
            {
              "count": 5,
              "type": "care"
            }
          ],
          "shared_post": null,
          "video_id": null
        }
      },
      "platform_type": "post",
      "published_at": "2026-11-02T22:30:00Z",
      "text": "Planning your trip to MAX POWER? We've got a tool for that.\n\nEvent schedules, maps, and FAQs are at your fingertips with the MAX POWER app. It's free and available to download from official app stores on iOS and Android devices: https://go.nasa.gov/3V2iiWX",
      "thumbnail_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/864280748_2020097565352172_6759494451320615303_n.png?stp=dst-jpg_tt6&cstp=mx2048x1294&ctp=s2048x1294&_nc_cat=111&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&…",
      "title": null,
      "type": "image",
      "unknown_fields": [],
      "url": "https://www.facebook.com/NASA/posts/pfbid02pjaLbfhAnFmrDoonxx7GyepT1H7pFbi9wrpqquL6oM5gTUJbfBE2BT2XchtG93r2l"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "facebook",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1578,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": "100044561550831",
      "url": "https://www.facebook.com/nasa"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.facebook.posts.list({ handle: "NASA" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "handle=" + encode("NASA");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/facebook/posts?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "handle=" + Uri.EscapeDataString("NASA"));
var res = await http.GetAsync("https://socialtap.dev/v1/facebook/posts?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/facebook/posts")
        .query(&[("handle", "NASA")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/facebook/postsLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

Null means unknown
A field Facebook doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
The Facebook profile (a Page's or a person's): its vanity name (NASA, case-insensitive), its numeric profile ID, or any link to it: facebook.com/<name> with any tab after it, profile.php?id=…, /people/<name>/<id>, /p/<name>-<id>.
Write one parser
Facebook, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring: Canonical post URL.
typestring: Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring: Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring: Caption, description or body as plain text.
languagestring: BCP-47 language of text, when the platform states it.

What teams build with the Facebook Profile Posts API.

Monitor a brand's Page for new posts
Export a Page's post history with engagement
Rank a Page's posts by reactions

Good to know before you build.

Each page holds the few posts Facebook's logged-out timeline serves at a time; follow next_cursor for more.
The pinned post isn't listed first: it appears at its publish date.
A profile Facebook shows nothing of logged out (not public, deactivated, age-restricted like an alcohol brand's Page, or an unknown name) returns private_or_unavailable, because Facebook answers them all the same way.
Comments are counted, not listed: the Facebook Comments API lists a post's comments.

1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

Plans and packs How this endpoint is priced How credits work

Source	Price per successful page	Per 1,000 pages
Any source	1 credit	$0.75–$1.97

Cache hits are free.
Credits from packs and top-ups never expire.
A monthly plan's credits are spent first, and what is left of them ends at each renewal.
Prices exclude tax: sales tax is added at checkout where it applies.
Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Facebook Profile Posts API.

Try it on an account you know.

Paste its handle or link in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Facebook Profile Posts API. Posts, page by page.