# Facebook Pages

Look up public Facebook pages and get a clean business profile for each — name, category, intro, follower and like counts, contact details (phone, email, website, address), rating, price range, hours, the confirmed owner behind the page, whether it's running ads, and its links to Instagram, X, YouTube, TikTok and more.

**Pricing:** $9.5 / 1k pages

**Endpoint:** `POST /api/v1/agents/facebook/pages/run`

**Auth:** `Authorization: Bearer mk_live_...`

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageUrls` | array | Yes | Facebook pages to look up, one per line — a handle like "nike" or a full URL like https://www.facebook.com/NASA/. Duplicate inputs are removed before the run. |

## Example

```bash
curl -X POST https://api.mindcase.co/api/v1/agents/facebook/pages/run \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{"pageUrls":["..."]}}'
```

```python
import requests

resp = requests.post(
    "https://api.mindcase.co/api/v1/agents/facebook/pages/run",
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
    json={"params": {
    "pageUrls": [
        "..."
    ]
}},
)
data = resp.json()
```

## Get the results

`run` is async and returns a `job_id`. Poll until `status` is `completed`, then read the rows:

```bash
# 1) check status
curl https://api.mindcase.co/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"

# 2) when status == completed, fetch the rows
curl https://api.mindcase.co/api/v1/jobs/JOB_ID/results \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"
```

Full API reference (auth, jobs, balance, endpoints): https://mindcase.co/skills.md

## Response columns

| Field | Display name | Type |
|-------|--------------|------|
| `pageName` | Page Name | text |
| `username` | Username | text |
| `pageUrl` | Page URL | text |
| `pageId` | Page ID | text |
| `category` | Category | text |
| `intro` | Intro | text |
| `pageCreated` | Page Created | text |
| `followers` | Followers | number |
| `likes` | Likes | number |
| `following` | Following | number |
| `talkingAbout` | Talking About | number |
| `wereHere` | Were Here | number |
| `phone` | Phone | text |
| `email` | Email | text |
| `website` | Website | text |
| `address` | Address | text |
| `addressMapUrl` | Address Map URL | text |
| `recommendPercent` | Recommend Percent | number |
| `reviewCount` | Review Count | number |
| `priceRange` | Price Range | text |
| `businessHours` | Business Hours | text |
| `services` | Services | array |
| `confirmedOwner` | Confirmed Owner | text |
| `runningAds` | Running Ads | boolean |
| `adLibraryId` | Ad Library ID | text |
| `profilePictureUrl` | Profile Picture URL | text |
| `coverPhotoUrl` | Cover Photo URL | text |
| `profilePhotoLink` | Profile Photo Link | text |
| `socialLinks` | Social Links | object_array |
| `personalProfile` | Personal Profile | object |