# See which ads are running for a term

**Use case:** 

Ready-to-run example: search the Meta Ad Library for a product term in one country and get the live ads with their creatives and run dates.

## Input

```json
{
  "searchTerms": [
    "protein powder"
  ],
  "adLibraryUrls": [],
  "advertiserPageIds": [],
  "countries": [
    "US"
  ],
  "maxAds": 100,
  "activeStatus": "active",
  "mediaType": "all",
  "publisherPlatforms": [],
  "exactPhrase": false,
  "onlyDynamicCreative": false,
  "excludeGated": false,
  "includeEmptyCreatives": false,
  "onlyNew": false,
  "concurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

## Output

```json
{
  "type": {
    "label": "Type"
  },
  "adArchiveId": {
    "label": "Ad ID"
  },
  "pageName": {
    "label": "Advertiser"
  },
  "title": {
    "label": "Headline"
  },
  "body": {
    "label": "Ad copy"
  },
  "ctaText": {
    "label": "CTA"
  },
  "linkUrl": {
    "label": "Destination"
  },
  "displayFormat": {
    "label": "Format"
  },
  "isDynamicCreative": {
    "label": "Dynamic"
  },
  "mediaCount": {
    "label": "Media"
  },
  "media": {
    "label": "Media URLs"
  },
  "variants": {
    "label": "Creative variants"
  },
  "startDate": {
    "label": "Started"
  },
  "endDate": {
    "label": "Ended"
  },
  "isActive": {
    "label": "Active"
  },
  "daysRunning": {
    "label": "Days running"
  },
  "collationCount": {
    "label": "Ads sharing creative"
  },
  "publisherPlatforms": {
    "label": "Platforms"
  },
  "pageLikeCount": {
    "label": "Page likes"
  },
  "pageCategories": {
    "label": "Page categories"
  },
  "pageUrl": {
    "label": "Page URL"
  },
  "adLibraryUrl": {
    "label": "Ad Library link"
  },
  "spend": {
    "label": "Spend"
  },
  "currency": {
    "label": "Currency"
  },
  "impressions": {
    "label": "Impressions"
  },
  "reachEstimate": {
    "label": "Reach"
  },
  "containsDigitalCreatedMedia": {
    "label": "AI-generated media"
  },
  "gatedType": {
    "label": "Gating"
  },
  "searchTerm": {
    "label": "Search term"
  },
  "searchCountry": {
    "label": "Country"
  },
  "reason": {
    "label": "Notice reason"
  },
  "message": {
    "label": "Notice"
  },
  "filter": {
    "label": "Dropped by filter"
  },
  "scrapedAt": {
    "label": "Scraped at"
  }
}
```

## About this Actor

This example demonstrates how to use [Facebook Ads Library Scraper - Meta Ad Library API + Creatives](https://apify.com/vonsensey/facebook-ads-library-scraper-meta-ad-api) with a specific input configuration. Visit the [Actor detail page](https://apify.com/vonsensey/facebook-ads-library-scraper-meta-ad-api) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/vonsensey/facebook-ads-library-scraper-meta-ad-api.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).