# Facebook Page Contact Info (`facebook.page_contact`)

Public contact details of a Facebook page (email, phone, website, address, price range, rating) by URL, handle or page id.

Docs: https://primaryapi.com/docs/api-reference/facebook/page_contact

- Endpoint: `POST https://api.primaryapi.com/v1/run/facebook.page_contact`
- Category: Social · Platform: `facebook` · Kind: lookup · Status: live
- Price: 2 credits per call; up to 14 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=facebook.page_contact`
- Execution: synchronous (answers 202 only if it outlives the wait window)
- Restricted: yes. Requires an approved account that accepted the permissible-purpose terms (`403 restricted_api` otherwise)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `page` | string | yes |  | max 2048 chars | Facebook page URL, handle or numeric page id, e.g. https://www.facebook.com/joesstonecrab. |
| `language` | enum | no | "en-US" | one of: af-ZA, az-AZ, bs-BA, br-FR, ca-ES, cx-PH, co-FR, cs-CZ, da-DK, en-GB, en-US, eo-EO, et-EE, eu-ES, tl-PH, fo-FO, fr-CA, fr-FR, fy-NL, ff-NG, gl-ES, de-DE, gn-PY, ha-NG, hr-HR, id-ID, ga-IE, is-IS, it-IT, jv-ID, rw-RW, ht-HT, ku-TR, lv-LV, lt-LT, hu-HU, mg-MG, ms-MY, mt-MT, nl-NL, nl-BE, nb-NO, nn-NO, pl-PL, pt-BR, pt-PT, ro-RO, sc-IT, sn-ZW, sq-AL, sz-PL, sk-SK, sl-SI, so-SO, es-LA, es-ES, fi-FI, sw-KE, sv-SE, tr-TR, uz-UZ, vi-VN, cy-GB, zz-TR, el-GR, be-BY, bg-BG, ky-KG, kk-KZ, mk-MK, mn-MN, ru-RU, sr-RS, tt-RU, tg-TJ, uk-UA, ka-GE, hy-AM, he-IL, ur-PK, ar-AR, ps-AF, fa-IR, cb-IQ, sy-SY, tz-MA, am-ET, ne-NP, mr-IN, hi-IN, as-IN, bn-IN, pa-IN, gu-IN, or-IN, ta-IN, te-IN, kn-IN, ml-IN, si-LK, th-TH, lo-LA, my-MM, km-KH, ko-KR, zh-TW, zh-CN, zh-HK, ja-JP, ja-KS | Facebook UI locale for the returned text, e.g. "en-US". |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `id` | string \| null | Facebook page id. |
| `title` | string \| null | Page name. |
| `url` | string \| null |  |
| `category` | string \| null |  |
| `about` | string \| null | Intro text. |
| `address` | string \| null |  |
| `email` | string \| null | Public contact email shown on the page. |
| `phone` | string \| null | Public phone shown on the page. |
| `website` | string \| null |  |
| `links` | string[] | Other links shown on the page. |
| `followers` | integer \| null |  |
| `image` | string \| null | Profile picture URL when the source exposes a direct image link. |
| `priceRange` | string \| null | e.g. "$$". |
| `rating` | string \| null | Rating text as shown, e.g. "94% recommend (839 Reviews)". |
| `services` | string \| null |  |
| `adLibraryPageId` | string \| null |  |
| `adStatus` | string \| null |  |
| `coverPhotoUrl` | string \| null |  |
| `createdUtc` | integer \| null | Page creation date, epoch seconds (UTC). |
| `items` | object[] | AnyAPI-compatible wrapper holding the single contact record. |
| `items[].adLibraryPageId` | string \| null |  |
| `items[].address` | string \| null |  |
| `items[].category` | string \| null |  |
| `items[].email` | string \| null |  |
| `items[].followers` | integer \| null |  |
| `items[].image` | string \| null |  |
| `items[].links` | string[] |  |
| `items[].phone` | string \| null |  |
| `items[].title` | string \| null |  |
| `items[].url` | string \| null |  |
| `items[].website` | string \| null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/facebook.page_contact" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"https://www.facebook.com/joesstonecrab"}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "id": "string",
      "title": "string",
      "url": "https://example.com",
      "category": "string",
      "about": "string",
      "address": "string",
      "email": "string",
      "phone": "string",
      "website": "string",
      "links": [
        "string"
      ],
      "followers": 0,
      "image": "string",
      "priceRange": "string",
      "rating": "string",
      "services": "string",
      "adLibraryPageId": "string",
      "adStatus": "string",
      "coverPhotoUrl": "https://example.com",
      "createdUtc": 0,
      "items": [
        {
          "adLibraryPageId": "string",
          "address": "string",
          "category": "string",
          "email": "string",
          "followers": 0,
          "image": "string",
          "links": [
            "string"
          ],
          "phone": "string",
          "title": "string",
          "url": "https://example.com",
          "website": "string"
        }
      ]
    }
  },
  "provider": "PrimaryAPI",
  "credits": 2,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z"
}
```

## Pricing and reliability

- Usual price: 2 credits per call
- Price ceiling: up to 14 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=facebook.page_contact`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`, `restricted_api`. See https://primaryapi.com/docs/errors.

## Notes

Contact fields come from the public page only.

## Legal

Returns email addresses, phone numbers and street addresses published on Facebook pages; for sole traders and creators these are personal data. Requires account approval and acceptance of a permissible-purpose clause: no spam or unsolicited outreach, no surveillance or profiling of individuals, lawful basis under GDPR/CCPA and compliance with CAN-SPAM/TCPA for any contact. Honour removal requests and do not keep results longer than needed.

