Facebook

Facebook

Profile / Page

per_call

Resolves a Facebook Page or public profile URL into a structured record with page name, username, category, about and description text, follower and like counts, verification badge, website, phone, address and cover imagery. Core data for local-business and brand monitoring.

What you get

Each call returns one profile record. There is no pagination.

Endpoint

GET /v1/facebook/profile-page

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

target
required
string

The Facebook profile or page — a bare username (`asif2bd`), `facebook.com/asif2bd`, or the full URL. Case does not matter.

fresh
optional
enum

Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.

One of: true, 1, false, 0

Example request

Live call. Successful calls are charged; failed and empty results are not.

curl
curl "https://fastfetchz.com/v1/facebook/profile-page?target=asif2bd" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "Facebook",
    "name": "Profile / Page",
    "slug": "profile-page"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "platform": "facebook",
    "id": "100044561550831",
    "username": "nasa",
    "display_name": "NASA - National Aeronautics and Space Administration",
    "url": "https://www.facebook.com/NASA/",
    "biography": "Explore the universe and discover our home planet. \nThere's space for everybody. ✨",
    "external_url": "https://www.nasa.gov/nasa-app/",
    "links": [],
    "avatar_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s480x480&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=EW2je1zCzQ4Q7kNvwGe-iok&_nc_oc=AdpZy-jqCfPb2mbwZwVkAxjRbaFy3sQ8mZ2Qt6Nb4DGPalu_zlVBqVSsayEtD9l1NSk&_nc_zt=24&_nc_ht=scontent-lga3-3.xx&_nc_gid=vdQY03k0rB8_2Z2ynIvszQ&_nc_ss=7f289&oh=00_AQL3I4sYjPmoCmxzWUWPEu1x2J_-5MD…",
    "banner_url": "https://scontent-lga3-2.xx.fbcdn.net/v/t39.30808-6/663298991_1496429661852405_5171518456419416626_n.jpg?stp=dst-jpg_tt6&cstp=mx2048x1366&ctp=s2048x1366&_nc_cat=105&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=iWNNzfUxU0AQ7kNvwE_Fs54&_nc_oc=AdqbUHzUOXyomlYd34RtVABz0XJ6dc7X8_rVQfWQJs6xKsDdekLigbpm4tfZQzKBVUU&_nc_zt=23&_nc_ht=scontent-lga3-2.xx&_nc_gid=vdQY03k0rB8_2Z2ynIvszQ&_nc_ss=7f289&oh=00_AQJbYipOPsIBFwlECLCi…",
    "category": "Government organization",
    "location": null,
    "is_verified": null,
    "is_private": null,
    "created_at": "2009-03-04T00:00:00.000Z",
    "follower_count": 28000000,
    "following_count": null,
    "post_count": null,
    "like_count": 28720284,
    "view_count": null,
    "contact": {
      "email": "public-inquiries@hq.nasa.gov",
      "phone": null,
      "address": null
    }
  }
}

Limits

  • Maximum per call: 1 profiles.
  • Minimum per call: 1 profile — a target with less data returns fewer profiles, and an empty result is still a successful call.
  • Each call fetches a full page of up to 1 and costs the same either way. Pass limit to receive fewer than that in the response.
  • This endpoint returns a single record per call and is not paginated.

What this costs in practice

10,000 profiles = 10,000 calls × 1 credits per call = 10,000 credits = $0.00

Priced at the Custom pack rate: 1,000,000 credits for $0.00.

Open in the pricing calculator

Guides using this endpoint

Error codes

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.