> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook

> Get Facebook Pages, posts, Marketplace listings and the Ad Library as structured data, as signed-out visitors see them, for 1 credit per link.

Send a Facebook link to [Scrape](https://docs.spidra.io/scrape.md) or [Batch scrape](https://docs.spidra.io/batch-scrape.md) and you get the data Facebook shows signed-out visitors, as JSON: a Page's details and its latest post, a post's reactions and comments, Marketplace listings, or Ad Library results. Each link costs 1 credit, and links that can't be read cost nothing.

## Example

```json theme={null}
{ "urls": ["https://www.facebook.com/nasa"], "output": "json", "wait": true }
```

The item's `result`, shortened:

```json theme={null}
{
  "type": "page",
  "name": "NASA - National Aeronautics and Space Administration",
  "username": "nasa",
  "category": "Government organization",
  "followers": 28743485,
  "talkingAbout": 235287,
  "websites": ["nasa.gov/nasa-app", "nasa.gov"],
  "latestPost": {
    "text": "We are not slowing down. 🚀\n\nOur Artemis III mission will send four astronauts to low Earth orbit next year...",
    "publishedAt": "2026-10-23T23:40:58.000Z",
    "reactions": 2492,
    "comments": 83,
    "shares": 286,
    "reactionTypes": [{ "name": "Like", "count": 2116 }, { "name": "Love", "count": 330 }, { "name": "Care", "count": 26 }]
  }
}
```

## Links that work

| Link | Example | You get |
| - | - | - |
| Page | `facebook.com/<name>`, `profile.php?id=...` | The Page's details and its latest post |
| Post | Post, video, reel, watch, permalink and share links | The post with exact reactions per type, comments, shares and plays |
| Marketplace list | A city, category or search page | Every listing in the first load |
| Marketplace item | `facebook.com/marketplace/item/<id>` | The listing with description, condition, location and all photos |
| Ad Library | `facebook.com/ads/library/?...` | A keyword search, an advertiser's ads or one ad: the total and the first page of about 30 ads |

## Fields

**Page:** `name`, `username`, `id`, `category`, `followers`, `likes`, `talkingAbout`, `checkIns`, `bio`, `websites`, `phone`, `email`, `address`, `coordinates`, `hoursStatus`, `priceRange`, `services`, `rating`, `recommendPercent`, `reviewCount`, `owner`, `otherAccounts`, `profilePicture`, `coverPhoto` and `latestPost` (`text`, `publishedAt`, `reactions`, `reactionTypes`, `comments`, `shares`, `views`, `media`, `links`). Most fields come from what the Page set in its intro, so they're `null` when it hasn't.

**Ad Library:** `totalCount`, `adCount`, `hasMore`, `advertiser`, and `ads`, each with `id`, `url`, `isActive`, `advertiser`, `startDate`, `endDate`, `platforms`, `format`, `title`, `body`, `linkUrl`, `ctaText`, `images`, `videos`, `cards`, `categories`, `spend`, `reachEstimate`, `impressions` and `countries`. A coffee keyword search found 50,001 ads and returned the first 30.

**Marketplace:** title, price, original price, city, photo, seller, delivery and date on a list; plus description, category, condition, location, coordinates and all photos on an item.

## Limits

* **One post per Page.** Signed-out visitors see only a Page's latest post (pinned posts left out); older posts need a sign-in.
* **Ad Library:** the first page of about 30 ads per link.
* **Not read:** groups, events, photo pages and a Page's ads transparency tab. Your cookies are never sent to Facebook.

## Templates

Ready-made [templates](https://docs.spidra.io/templates.md) for Facebook: Page stats, latest post from Pages, post metrics, Ad Library search, ads by advertiser, and Marketplace listings and item details.

> [!NOTE]
>
> Check Facebook's terms before you collect data from it. You're responsible for how you use what you collect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.