# Find UK skincare ads in the Facebook Ad Library

**Use case:** 

Search the Meta Ad Library by keyword and country and export every matching ad from Facebook and Instagram. This example finds active skincare ads shown in the United Kingdom, newest first, with the advertiser, ad copy, creatives, landing page and days running. Change the keyword and the country to research any market.

## Input

```json
{
  "searchTerms": [
    "skincare"
  ],
  "countries": [
    "GB"
  ],
  "activeStatus": "active",
  "adType": "all",
  "mediaType": "all",
  "searchMode": "keyword_unordered",
  "sortBy": "most_recent",
  "skipDuplicateVersions": false,
  "oneAdPerAdvertiser": false,
  "maxAdsPerSource": 100,
  "includeAdDetails": false,
  "countOnly": false,
  "includeMarkdown": false,
  "includeRawData": false,
  "onlyNewAds": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "maxConcurrency": 4,
  "maxRetries": 6
}
```

## Output

```json
{
  "pageProfilePictureUrl": {
    "label": "Page picture",
    "format": "string"
  },
  "pageName": {
    "label": "Advertiser",
    "format": "string"
  },
  "status": {
    "label": "Status",
    "format": "string"
  },
  "startDate": {
    "label": "Started",
    "format": "string"
  },
  "daysRunning": {
    "label": "Days running",
    "format": "integer"
  },
  "platforms": {
    "label": "Platforms",
    "format": "array"
  },
  "mediaType": {
    "label": "Media type",
    "format": "string"
  },
  "title": {
    "label": "Headline",
    "format": "string"
  },
  "bodyText": {
    "label": "Ad text",
    "format": "string"
  },
  "ctaText": {
    "label": "Call to action",
    "format": "string"
  },
  "linkDomain": {
    "label": "Landing domain",
    "format": "string"
  },
  "adLibraryUrl": {
    "label": "Ad Library link",
    "format": "string"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Facebook Ads Library Scraper & Ad Monitor Actor is ready to run with the inputs already set for "Find UK skincare ads in the Facebook Ad Library". [Sign up or log in](https://console.apify.com/create-task-from-example/vn8dMwt5KTY4eGcsj) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Find UK skincare ads in the Facebook Ad Library" task

The Facebook Ads Library Scraper & Ad Monitor Actor will start running based on the input automatically. You can also change all the input fields, like search terms (keywords or brand names), countries, and more, to match your specific use case.

### 3. Receive the "Find UK skincare ads in the Facebook Ad Library" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as page picture, advertiser, status, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Find UK skincare ads in the Facebook Ad Library" task via API](https://apify.com/panix/facebook-ads-library-scraper.md).

## FAQ

### Which ads does the UK skincare ads task find?

The UK skincare ads task finds the ads that match the keyword in the Meta Ad Library for the chosen country, the same results as a keyword search on facebook.com/ads/library, sorted newest first.

### Can I search an exact phrase or several keywords?

Add several keywords to Search terms; each one is searched on its own and duplicates are removed. Set Keyword match to exact phrase in the UK skincare ads task to match the words in that order only.

### Which countries can I search?

Any country Meta lists in the Ad Library, or all countries at once. The UK skincare ads task uses GB; pick several countries to compare markets in one run.

### How much does the UK skincare ads task cost?

The UK skincare ads task costs $0.60 per 1,000 ads on the Apify Free plan and $0.50 on Starter, less on Scale and Business, plus $0.003 per run. You choose the maximum number of ads per search.

## About this Actor

This example demonstrates how to use [Facebook Ads Library Scraper & Ad Monitor](https://apify.com/panix/facebook-ads-library-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/panix/facebook-ads-library-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

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

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
