scrollport

Facebook ad library company ads by page id or name

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

by ScrapeCreatorsReady to run$0.0027 per request · $0.27 per 100 requests

Example

You ask your agent

“Show me the ads this Facebook page is running, from the Meta Ad Library.”

You get

Categories
UNKNOWN
Snapshot title
Bina Edit ke
Cards
Bina Edit ke
Caption
play.google.com
Page categories
App page
Body text
Har din ke palon ke liye Storiz bani thin. Instagram apni jingi ke hisson ko share karein.
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

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

Response

{
  "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"
        ]
      }
    ]
  }
}

Use it with your agent

Copy the prompt and paste it into your agent, then 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.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 2 →

Questions

Is Facebook ad library company ads by page id or name (ScrapeCreators) free?

Scrollport has no free tier: it costs $0.0027 per request ($0.27 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from ScrapeCreators?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to ScrapeCreators, so you don't sign up with ScrapeCreators or manage an API key.

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.

All inputs and outputs

Input

companyNamestring · optional

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

minLength: 1 · maxLength: 500

countrystring · 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

cursorstring · optional

Cursor to paginate through results

minLength: 1 · maxLength: 4096

end_datestring · optional

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

minLength: 1 · maxLength: 500

languagestring · optional

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

minLength: 1 · maxLength: 500

media_typestring · 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

pageIdstring · 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_bystring · 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_datestring · optional

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

minLength: 1 · maxLength: 500

statusstring · optional

Status of the ad. Defaults to ACTIVE.

minLength: 1 · maxLength: 500

trimboolean · optional

Set to true for a trimmed down version of the response

Output

dataobject

Main result payload.

Errors and limits
  • 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.