# Facebook Ad Library EU Report

Get one section of the regional ad transparency report. The report is published as six separate sections and each section is its own report, so section is required and each request covers exactly one upstream lookup and costs one credit. The default time range covers the full history: the report only covers social-issue, election and political advertising from October 2019 onward, so short ranges such as yesterday or the last seven days can legitimately contain no rows. Reach figures in this report are coarse display buckets rather than measured per-ad reach.

- **Documentation:** [https://scrappa.co/docs/facebook-ad-library-api/meta_ad_library_eu_report](https://scrappa.co/docs/facebook-ad-library-api/meta_ad_library_eu_report)
- **API group:** Facebook Ad Library API
- **Endpoint:** `GET https://scrappa.co/api/facebook-ad-library/eu-report`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `section` | string | Yes | Report section to return: overview, searches, campaign-tracker, advertisers, locations or download-availability. |
| `country` | string | No | Two-letter ISO country code the report covers. |
| `time_preset` | string | No | Reporting range for the locations, advertisers and campaign-tracker sections. Defaults to LIFELONG, the full history. Short ranges may legitimately return no rows. The overview always covers the full history and echoes LIFELONG; searches and download-availability echo no range. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/facebook-ad-library/eu-report?section=overview&country=DE"
```

## Example response

```json
{
    "report_parameters": {
        "section": "overview",
        "country": "DE",
        "time_preset": "LIFELONG",
        "report_date": "2026-10-04"
    },
    "section_data": {
        "ads_count": 1187144,
        "spend": 158900285
    },
    "reach_note": "Reach figures in this report are coarse display buckets, not a measured per-ad reach count.",
    "response_time_ms": 2100
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Ad library temporarily unavailable | The public ad library could not be reached. The request is not billed. |
| 422 | Unsupported filter value | One of the filter values is outside the published set. No upstream request is made and no credits are charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)