# Facebook ad library company ads by page id or name

ScrapeCreators

Fetches all ads currently running for a specific company from the Meta Ad Library.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Facebook ad library company ads by page id or name (tool ID: scrapecreators.v1-facebook-adlibrary-company-ads). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search the Meta Ad Library](https://scrollport.com/tools/meta-ad-library-api)

**Current price:** $0.0027/request

**Availability:** Ready to run

## Tool details

**About this tool**

Fetches all ads currently running for a specific company from the Meta Ad Library. Retrieve one bounded result or page using the documented fields. Pagination is explicit: follow-up pages require another run. The catalog price is the maximum per request; the upfront quote reflects the selected limits. Completed requests cost that quote, including valid empty pages and no-match answers. Supplier waivers do not change the customer price. Failed requests are uncharged. Results contain reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most the first item of each list.

**Inputs and outputs**

### Input

`companyName` string · optional

The name of the company. Can either use this or pageId

minLength: 1 · maxLength: 500

`country` string · optional

This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.

minLength: 1 · maxLength: 500

`cursor` string · optional

Cursor to paginate through results

minLength: 1 · maxLength: 4096

`end_date` string · optional

End date to search for. Format: YYYY-MM-DD

minLength: 1 · maxLength: 500

`language` string · optional

Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc

minLength: 1 · maxLength: 500

`media_type` string · optional

Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.

minLength: 1 · maxLength: 500

`pageId` string · optional

The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName

minLength: 1 · maxLength: 500

`sort_by` string · optional

Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.

minLength: 1 · maxLength: 500 · enum: impressions, relevancy_monthly_grouped

`start_date` string · optional

Start date to search for. Format: YYYY-MM-DD

minLength: 1 · maxLength: 500

`status` string · optional

Status of the ad. Defaults to ACTIVE.

minLength: 1 · maxLength: 500

`trim` boolean · optional

Set to true for a trimmed down version of the response

### Output

`data` object

Returned data value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "scrapecreators.v1-facebook-adlibrary-company-ads",
  "input": {
    "pageId": "367152833370567"
  }
}
```

### Output

```
{
  "data": {
    "results": [
      {
        "snapshot": {
          "body": {
            "text": "Har din ke palon ke liye Storiz bani thin. Instagram apni jingi ke hisson ko share karein."
          },
          "cards": [
            {
              "title": "Bina Edit ke"
            }
          ],
          "title": "Bina Edit ke",
          "caption": "play.google.com",
          "page_categories": [
            "App page"
          ]
        },
        "categories": [
          "UNKNOWN"
        ]
      }
    ]
  }
}
```

**Errors and limitations**

- `invalid_input`: The lookup fields or limits are invalid.example: {"pageId":"367152833370567"}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/scrapecreators/v1-facebook-adlibrary-company-ads