Profile Posts
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook/profile/posts \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook/profile/posts"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook/profile/posts', 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://api.sociavault.com/v1/scrape/facebook/profile/posts",
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: <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://api.sociavault.com/v1/scrape/facebook/profile/posts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook/profile/posts")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook/profile/posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"posts": {
"0": {
"id": "1530759742389661",
"text": "Most people never reach their Mount Everest because they never define it.\n\n“Be successful” is not a mountain.\nIt’s just a direction.\n\nYour Mount Everest is the end goal.\n\nTo define it clearly, use a framework like SMART. Here’s what that might look like:\n\nSpecific:\nDefine the exact life you want, not just the next move.\n\nMeasurable:\nIncome, time freedom, control, impact. Put numbers to it.\n\nAchievable:\nBig enough to matter. Real enough to pursue.\n\nRelevant:\nAligned with your values and what you truly want to accomplish in life.\n\nTime-bound:\nA clear timeline to make it happen. No one ever made an “eventually” goal and stuck to it.\n\nA real Mount Everest sounds something like this:\n“I want to cash flow 100k/month before 2040 by focusing on RV parks and mobile homes so I can ensure financial freedom and spend more time on my hobbies and with family without the headache and constant stress of work.”\n\nThat’s the mountain.\nEverything else is just the path.\n\nDefine the end goal.\nThen work backward.",
"url": "https://www.facebook.com/reel/1020832793820089/",
"permalink": "https://www.facebook.com/reel/1020832793820089/",
"author": {
"__typename": "User",
"name": "Pace Morby",
"short_name": "Pace Morby",
"id": "100063669491743"
},
"videoDetails": {
"sdUrl": "https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMQwlyJ3SL04ySrg56moM2o9XaGGC66aUpTP54bhsfgKmIDPcI2hozN_CGYxdawngPXo7B8DVnDQ0gSC2pRRXwIRJsFbT_gPRophAa75A.mp4?_nc_cat=103&_nc_sid=8bf8fe&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=TWWiBycP0tYQ7kNvwGTi0m7&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NDIzNTc0Mzg2MDAxODc5NCwiYXNzZXRfYWdlX2RheXMiOjQzLCJ2aV91c2VjYXNlX2lkIjoxMDEyNywiZHVyYXRpb25fcyI6ODAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=wyxwHqw83Znfal86BF7KbQ&_nc_zt=28&oh=00_Afu8t_JDYCbMYqmNsUFzx1WqLYhFv9jziwxdHMJ0RNBW-A&oe=698EDE73&bitrate=224776&tag=sve_sd",
"hdUrl": "https://video-atl3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQMFD3iiKC5e5TiUnSFJ9ovUH1aWUnjrDdkdngz42z7fGxgbpy4vtKk4XKOA-uJ17HlwooTebdSekSj-29XdqGCX_6HqbKIKDktXTu308oEZHQ.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=video-atl3-2.xx.fbcdn.net&_nc_ohc=M15IcfI44GEQ7kNvwGY_fol&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjQyMzU3NDM4NjAwMTg3OTQsImFzc2V0X2FnZV9kYXlzIjo0MywidmlfdXNlY2FzZV9pZCI6MTAxMjcsImR1cmF0aW9uX3MiOjgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=83b4170c6f23c54&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC8yNzQxNkQ5NjI1MDRGNEY0MzU4MDhENjA1QjVFRjA5Q19tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0JENDlBRDM1OUZGRkQxMTRBNjc2RjI2RkJGRkFFRjlBX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbUuZaC35iGDxUCKAJDMywXQFQKn752yLQYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZ6eAQA&_nc_gid=wyxwHqw83Znfal86BF7KbQ&_nc_zt=28&oh=00_AfvyOcpT_27LpsDu5TvObBNwx1WRj5ZgMX1o_rwTcv2Twg&oe=698F0510&bitrate=664806&tag=dash_h264-basic-gen2_720p",
"thumbnailUrl": "https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/608335501_1020833387153363_190016405962712638_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=be8305&_nc_ohc=yyYe-qsz1YwQ7kNvwFvUJii&_nc_oc=AdnMzKjdwf8lubyjcxmFUMM2psRXy-Gw7Xkj7laZU89MJszOvMegfzjH1_OeQZcjiIA&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=wyxwHqw83Znfal86BF7KbQ&oh=00_AfsmkkFinhvKN7PRv2L2YU8KmFDisySgjlE6nITHfJAJHg&oe=698EE9CF"
},
"image": "https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/608335501_1020833387153363_190016405962712638_n.jpg?stp=dst-jpg_p565x565_tt6&_nc_cat=104&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=yyYe-qsz1YwQ7kNvwFvUJii&_nc_oc=AdnMzKjdwf8lubyjcxmFUMM2psRXy-Gw7Xkj7laZU89MJszOvMegfzjH1_OeQZcjiIA&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=wyxwHqw83Znfal86BF7KbQ&oh=00_Afs35klV4U_Dw8K5gSI9C5xl-igDBtSWg75_POU8Y6pCfg&oe=698EE9CF",
"reactionCount": 310,
"commentCount": 20,
"videoViewCount": null,
"publishTime": 1766806463,
"topComments": {}
}
},
"cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAAB2kFRSFN1UFVxSUdFaV9WTElYcDRuNHdNNE41SDU5WGtBY2RrSFpSRWFEWUo2N1Uwa1BVRHQ1WVNJeEhia1E0cWZwLVotQnFlYnd0ZkNWSnBURWFJVUxaZlJONk1kM3o2T3ZBVTQzMzhIS2tzSWJOVnYxUFNhZU8ybFNVN000cnMxdlRwNVBoLUJBeDFhZHFEWlhJd1R0d2Q1Tk5TZDFOSEV0WnpKa185VFBTVW8wSGJONmFhLURBQXFxQmxWMTNnWUR3ZEpTSnh5SzF4NlRPMERuZkUycHE5aEdpY3V3bDljQnlBcUxoNm5JdUU1TTFoMm9vZWlja3hzMmVzdTRjc2xVb25hZTJIQzZSSTVuQUJBaGpZWHBVY0FvSVMzZHJZQmZxSWFRbTBDei1pbEdObUVLam1KX2dDSlQ3QWFrYU83MGZub3NNRUlMTThNNVBqVzNRdmg1TGU5aGsxNFBQeVFMeTJ5SVpJZno2ZjJZRk53NEtjZ0dnZFV2NjcxUWxfcF9hX2JkV2Y5Yl9aYkF0QkRBSDZZZ2dnVzBBd1NQVzAyYktMZjBaZTQ4UEFVV1Z5ZkJZMkJzX01lRldDVmFTQlRyTnpzR2hLMmd2Zzc2dWVjemM2RTdDQl9xdw8JYWRfY3Vyc29yDg8PZ2xvYmFsX3Bvc2l0aW9uAgAPBm9mZnNldAIADxBsYXN0X2FkX3Bvc2l0aW9uAv8B"
},
"credits_used": 1,
"endpoint": "facebook/profile/posts"
}{
"error": "Missing required parameter: handle",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}Facebook
Profile Posts
Get publicly visible posts from a Facebook profile — equivalent to what is accessible without being logged in. Accepts a profile URL or pageId (recommended for faster responses). Returns up to 3 posts per request.
GET
/
v1
/
scrape
/
facebook
/
profile
/
posts
Profile Posts
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook/profile/posts \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook/profile/posts"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook/profile/posts', 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://api.sociavault.com/v1/scrape/facebook/profile/posts",
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: <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://api.sociavault.com/v1/scrape/facebook/profile/posts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook/profile/posts")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook/profile/posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"posts": {
"0": {
"id": "1530759742389661",
"text": "Most people never reach their Mount Everest because they never define it.\n\n“Be successful” is not a mountain.\nIt’s just a direction.\n\nYour Mount Everest is the end goal.\n\nTo define it clearly, use a framework like SMART. Here’s what that might look like:\n\nSpecific:\nDefine the exact life you want, not just the next move.\n\nMeasurable:\nIncome, time freedom, control, impact. Put numbers to it.\n\nAchievable:\nBig enough to matter. Real enough to pursue.\n\nRelevant:\nAligned with your values and what you truly want to accomplish in life.\n\nTime-bound:\nA clear timeline to make it happen. No one ever made an “eventually” goal and stuck to it.\n\nA real Mount Everest sounds something like this:\n“I want to cash flow 100k/month before 2040 by focusing on RV parks and mobile homes so I can ensure financial freedom and spend more time on my hobbies and with family without the headache and constant stress of work.”\n\nThat’s the mountain.\nEverything else is just the path.\n\nDefine the end goal.\nThen work backward.",
"url": "https://www.facebook.com/reel/1020832793820089/",
"permalink": "https://www.facebook.com/reel/1020832793820089/",
"author": {
"__typename": "User",
"name": "Pace Morby",
"short_name": "Pace Morby",
"id": "100063669491743"
},
"videoDetails": {
"sdUrl": "https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMQwlyJ3SL04ySrg56moM2o9XaGGC66aUpTP54bhsfgKmIDPcI2hozN_CGYxdawngPXo7B8DVnDQ0gSC2pRRXwIRJsFbT_gPRophAa75A.mp4?_nc_cat=103&_nc_sid=8bf8fe&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=TWWiBycP0tYQ7kNvwGTi0m7&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NDIzNTc0Mzg2MDAxODc5NCwiYXNzZXRfYWdlX2RheXMiOjQzLCJ2aV91c2VjYXNlX2lkIjoxMDEyNywiZHVyYXRpb25fcyI6ODAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=wyxwHqw83Znfal86BF7KbQ&_nc_zt=28&oh=00_Afu8t_JDYCbMYqmNsUFzx1WqLYhFv9jziwxdHMJ0RNBW-A&oe=698EDE73&bitrate=224776&tag=sve_sd",
"hdUrl": "https://video-atl3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQMFD3iiKC5e5TiUnSFJ9ovUH1aWUnjrDdkdngz42z7fGxgbpy4vtKk4XKOA-uJ17HlwooTebdSekSj-29XdqGCX_6HqbKIKDktXTu308oEZHQ.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=video-atl3-2.xx.fbcdn.net&_nc_ohc=M15IcfI44GEQ7kNvwGY_fol&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjQyMzU3NDM4NjAwMTg3OTQsImFzc2V0X2FnZV9kYXlzIjo0MywidmlfdXNlY2FzZV9pZCI6MTAxMjcsImR1cmF0aW9uX3MiOjgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=83b4170c6f23c54&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC8yNzQxNkQ5NjI1MDRGNEY0MzU4MDhENjA1QjVFRjA5Q19tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0JENDlBRDM1OUZGRkQxMTRBNjc2RjI2RkJGRkFFRjlBX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbUuZaC35iGDxUCKAJDMywXQFQKn752yLQYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZ6eAQA&_nc_gid=wyxwHqw83Znfal86BF7KbQ&_nc_zt=28&oh=00_AfvyOcpT_27LpsDu5TvObBNwx1WRj5ZgMX1o_rwTcv2Twg&oe=698F0510&bitrate=664806&tag=dash_h264-basic-gen2_720p",
"thumbnailUrl": "https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/608335501_1020833387153363_190016405962712638_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=be8305&_nc_ohc=yyYe-qsz1YwQ7kNvwFvUJii&_nc_oc=AdnMzKjdwf8lubyjcxmFUMM2psRXy-Gw7Xkj7laZU89MJszOvMegfzjH1_OeQZcjiIA&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=wyxwHqw83Znfal86BF7KbQ&oh=00_AfsmkkFinhvKN7PRv2L2YU8KmFDisySgjlE6nITHfJAJHg&oe=698EE9CF"
},
"image": "https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/608335501_1020833387153363_190016405962712638_n.jpg?stp=dst-jpg_p565x565_tt6&_nc_cat=104&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=yyYe-qsz1YwQ7kNvwFvUJii&_nc_oc=AdnMzKjdwf8lubyjcxmFUMM2psRXy-Gw7Xkj7laZU89MJszOvMegfzjH1_OeQZcjiIA&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=wyxwHqw83Znfal86BF7KbQ&oh=00_Afs35klV4U_Dw8K5gSI9C5xl-igDBtSWg75_POU8Y6pCfg&oe=698EE9CF",
"reactionCount": 310,
"commentCount": 20,
"videoViewCount": null,
"publishTime": 1766806463,
"topComments": {}
}
},
"cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAAB2kFRSFN1UFVxSUdFaV9WTElYcDRuNHdNNE41SDU5WGtBY2RrSFpSRWFEWUo2N1Uwa1BVRHQ1WVNJeEhia1E0cWZwLVotQnFlYnd0ZkNWSnBURWFJVUxaZlJONk1kM3o2T3ZBVTQzMzhIS2tzSWJOVnYxUFNhZU8ybFNVN000cnMxdlRwNVBoLUJBeDFhZHFEWlhJd1R0d2Q1Tk5TZDFOSEV0WnpKa185VFBTVW8wSGJONmFhLURBQXFxQmxWMTNnWUR3ZEpTSnh5SzF4NlRPMERuZkUycHE5aEdpY3V3bDljQnlBcUxoNm5JdUU1TTFoMm9vZWlja3hzMmVzdTRjc2xVb25hZTJIQzZSSTVuQUJBaGpZWHBVY0FvSVMzZHJZQmZxSWFRbTBDei1pbEdObUVLam1KX2dDSlQ3QWFrYU83MGZub3NNRUlMTThNNVBqVzNRdmg1TGU5aGsxNFBQeVFMeTJ5SVpJZno2ZjJZRk53NEtjZ0dnZFV2NjcxUWxfcF9hX2JkV2Y5Yl9aYkF0QkRBSDZZZ2dnVzBBd1NQVzAyYktMZjBaZTQ4UEFVV1Z5ZkJZMkJzX01lRldDVmFTQlRyTnpzR2hLMmd2Zzc2dWVjemM2RTdDQl9xdw8JYWRfY3Vyc29yDg8PZ2xvYmFsX3Bvc2l0aW9uAgAPBm9mZnNldAIADxBsYXN0X2FkX3Bvc2l0aW9uAv8B"
},
"credits_used": 1,
"endpoint": "facebook/profile/posts"
}{
"error": "Missing required parameter: handle",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}💳 1 credit per request
Authorizations
Query Parameters
Facebook profile URL
Example:
"https://www.facebook.com/pacemorby"
Facebook profile page id
Example:
"100063669491743"
To paginate through the posts
Example:
"Cg8Ob3JnYW5pY19jdXJzb3IJA..."
Response
Successful response
Key Response Fields:
data.posts[0].id: Post IDdata.posts[0].text: Post text/captiondata.posts[0].url: Direct URL to the post or reeldata.posts[0].author.name: Name of the page that posteddata.posts[0].reactionCount: Total reaction (like/love/etc.) countdata.posts[0].commentCount: Total comment countdata.posts[0].publishTime: Unix timestamp of when the post was publisheddata.posts[0].videoDetails.sdUrl: SD video stream URL (if a video post)data.posts[0].videoDetails.hdUrl: HD video stream URL (if a video post)data.posts[0].videoDetails.thumbnailUrl: Video thumbnail URLdata.posts[0].image: Static post image URL (for image posts)data.cursor: Pagination cursor — pass ascursorto get the next 3 posts
⌘I