Profile
A profile or Page: its name, category, bio, followers, picture and cover, and the details its Intro shows logged out, such as a Page's address, phone, email, website, hours and rating.
GET/v1/facebook/profile1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
2handlestringoptionalqueryA profile's or Page's handle: the part of its link after facebook.com/ (uniladmag), or its id. Give handle or url.
example: uniladmag
urlstringoptionalqueryA profile's or Page's link: facebook.com/<handle>, /profile.php?id=<id> or /people/<name>/<id>. Give handle or url.
max 300 chars
Response fields
31dataobjectThe result: one object, or a list for the endpoints that return several.
data.idstringFacebook's id for the profile or Page: digits, written as text.
data.page_idstringnullableThe Page's id where the profile is a Page's: the Ad Library's page_id takes it.
data.urlstringThe profile's link.
data.namestringnullableIts name.
data.verifiedbooleannullableWhether Facebook shows its blue badge.
data.categorystringnullableWhat the Page says it is (Entertainment website, Public figure).
data.biostringnullableThe text at the top of its Intro.
data.followersintegernullableFollowers, exact.
data.followingintegernullableProfiles and Pages it follows, where it shows them; Facebook rounds large numbers.
data.talking_aboutintegernullablePeople talking about it, a Page's count of recent engagement.
data.picturestringnullableIts profile picture's link.
data.coverstringnullableIts cover photo's link.
data.addressstringnullableWhere it is, as the Page gives it.
data.phonestringnullableIts phone number.
data.emailstringnullableIts email address.
data.websitestringnullableIts website.
data.hoursstringnullableIts opening hours, as Facebook sums them up (Always open, Open now).
data.ratingstringnullableIts rating, as Facebook writes it (100% recommend (7 reviews)).
data.introstring[]nullableEvery line of its Intro, as Facebook shows it: a person's work, studies and places, a Page's details.
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether it came from our cache; fetched_at says how old it is.
default: false
Code example
curl -X GET 'https://api.socialparse.dev/v1/facebook/profile?handle=uniladmag' \ -H 'x-api-key: YOUR_API_KEY'Responses
Successful Response
{ "data": { "id": "string", "page_id": "string", "url": "string", "name": "string", "verified": true, "category": "string", "bio": "string", "followers": 0, "following": 0, "talking_about": 0, "picture": "string", "cover": "string", "address": "string", "phone": "string", "email": "string", "website": "string", "hours": "string", "rating": "string", "intro": [ "string" ] }, "page": { "next_cursor": "string", "has_more": false }, "meta": { "platform": "string", "endpoint": "string", "params": { "property1": "string", "property2": "string" }, "request_id": "string", "api_version": "string", "fetched_at": "2019-08-24T14:15:22Z", "cached": false }}