---
title: "Ad Details"
method: GET
path: "/v1/facebook/adLibrary/ad"
tags: ["Facebook Ad Library"]
---

# Ad Details

`GET /v1/facebook/adLibrary/ad`

Retrieves detailed information about a specific Facebook ad by its ID or URL. Returns adArchiveID, pageName, isActive, startDate, endDate, and a snapshot containing body, images, videos, display_format, link_url, and cta_text. Regulated ads may also include source-dependent aaa_info using the structure shown below. Political and social issue delivery data is normalized to location_audience and age_country_gender_reach_breakdown. Political location_audience rows include reach, and political delivery values are fractional shares, so 0.08 means 8%. Regional transparency data may use absolute reach counts. For ads with multiple versions, the ad creative is found in the snapshot.cards array rather than snapshot.body.

## Query parameters

- `id` string
- `url` string
- `trim` boolean
- `cache_max_age` '1d' | '3d' | '7d' | '14d' | '30d'

## Response `200`

Successful response

---

[API](https://skmtc.dev/scrapecreators/apis/scrape-creators-api.md) · [All operations](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapecreators/scrape-creators-api/revisions/e9ec3dbbd8b8/schema)