Facebook Profile API

Get a Facebook Page's profile: name, category, followers, links and contact details.

GET | POST /v1/facebook/profile

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Request

curl "https://gateway.apinoa.com/v1/facebook/profile?username=nasa" \
  -H "x-api-key: $APINOA_API_KEY"

What to Pass

Pass	Reads	Notes
`username`	The Page	Its vanity name (`nasa`), its numeric id, or the Page URL

Every identifier also takes the page URL.

Parameters

Parameter	Type	Required	Notes
`username`	string		The Page's vanity name (e.g. nasa), its numeric id, or the Page URL.

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns Account in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "success": true,
  "data": {
    "platform": "facebook",
    "id": "54971236771",
    "handle": "NASA",
    "displayName": "NASA - National Aeronautics and Space Administration",
    "bio": "Explore the universe and discover our home planet. \nThere's space for everybody. ✨",
    "url": "https://www.facebook.com/NASA",
    "avatarUrl": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036…",
    "bannerUrl": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.99422-6/809146614_448401392…",
    "verified": true,
    "counts": {
      "followers": 28730940,
      "following": 52
    },
    "links": [
      {
        "url": "https://www.nasa.gov/nasa-app/",
        "title": "nasa.gov/nasa-app"
      },
      {
        "url": "https://www.nasa.gov/",
        "title": "nasa.gov"
      }
    ],
    "category": "Government organization",
    "ext": {
      "profileId": "100044561550831",
      "followersText": "28M followers",
      "followingText": "52 following",
      "talkingAbout": 116622,
      "email": "public-inquiries@hq.nasa.gov",
      "confirmedOwner": "NATIONAL AERONAUTICS AND SPACE ADMINISTRATION",
      "categoryText": "Page · Government organization",
      "cover": {
        "id": "1629624498532920",
        "width": 960,
        "height": 697
      },
      "intro": [
        {
          "type": "INTRO_CARD_INFLUENCER_CATEGORY",
          "text": "Page · Government organization"
        },
        {
          "type": "INTRO_CARD_CONFIRMED_OWNER_LABEL",
          "text": "NATIONAL AERONAUTICS AND SPACE ADMINISTRATION",
          "subtitle": "is responsible for this Page"
        }
      ]
    }
  }
}

Errors

Status	Code	Meaning
400	`INVALID_PARAMS`	A parameter is missing, unknown or out of range. The message names it.
401	`UNAUTHORIZED`	The `x-api-key` header is missing, or the key is revoked or unknown.
402	`INSUFFICIENT_BALANCE`	The balance does not cover this call. Top up in the dashboard.
404	`NOT_FOUND`	The account, post or group does not exist, or is private, deleted or age-restricted.
429	`MARKETPLACE_SATURATED`	Too many concurrent calls. Retry after the `Retry-After` seconds.
502	`UPSTREAM_ERROR`	The platform answered with something unusable. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.001 per call. List price; the rate steps down above 1,000 calls a day.

Notes

The Page's own facts beyond the shared fields (email, phone, address, hours, price range, rating, the confirmed owner, every item of its intro) are in ext, under the names the Page shows them.
id is the Page id ads takes as pageId.

Profile