/v1/facebook/profile/posts
Profile Posts
Get public Facebook profile posts visible without login, 3 per page, with available link previews and video details. Provide url or pageId; pageId is faster.
| Credit cost | Default: 1 credit How charges are determinedCost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute. |
|---|---|
| Cache support | Not specified in the published contract. |
| Pagination | No explicit pagination metadata in the published contract. Consult the parameters and response fields below. |
Parameters
| Name | Location / required | Schema |
|---|---|---|
urlFacebook profile URL | query / optional |
|
pageIdFacebook profile page id | query / optional |
|
cursorTo paginate through the posts | query / optional |
|
Request examples
Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.
cURL
curl --request GET 'https://api.fetchproof.com/v1/facebook/profile/posts' \
--header 'x-api-key: YOUR_API_KEY'JavaScript
const response = await fetch("https://api.fetchproof.com/v1/facebook/profile/posts", {
method: 'GET',
headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());Python
import os
import requests
response = requests.get("https://api.fetchproof.com/v1/facebook/profile/posts",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)Responses
200Success. Envelope: success / credits_remaining / credits_charged.
application/json
object
successrequired
boolean
credits_remainingrequired
integer
credits_chargedrequired
integer
postsrequired
array
Array items
object
idrequired
string
is_paid_partnershiprequired
null
textrequired
string
urlrequired
string
permalinkoptional
string
authorrequired
object
__typenamerequired
string
namerequired
string
short_namerequired
string
idrequired
string
videoDetailsrequired
object
sdUrloptional
string
hdUrloptional
string
thumbnailUrloptional
string
reactionCountrequired
integer
commentCountrequired
integer
videoViewCountrequired
integer
publishTimerequired
integer
topCommentsrequired
array
Array items
object
idrequired
string
textrequired
string
publishTimerequired
integer
authorrequired
object
idrequired
string
namerequired
string
genderrequired
string
urlrequired
string
imageoptional
string
imagesoptional
array
Array items
string
share_countoptional
integer
reaction_countsoptional
object
thankfulrequired
integer
likerequired
integer
loverequired
integer
carerequired
integer
haharequired
integer
wowrequired
integer
sadrequired
integer
angerrequired
integer
priderequired
integer
confusedrequired
integer
creation_timeoptional
string
{
"format": "date-time"
}cursorrequired
string