---
title: "Company Ads"
method: POST
path: "/v1/facebook/adLibrary/company/ads"
tags: ["Facebook Ad Library"]
---

# Company Ads

`POST /v1/facebook/adLibrary/company/ads`

Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body, images, videos, and display_format. Supports filtering by country, media_type, date range, and language with cursor-based pagination. Both GET and POST are supported. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body.

## Request body

- object
  - `pageId` string — The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName
  - `companyName` string — The name of the company. Can either use this or pageId
  - `country` string — This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
  - `status` 'ALL' | 'ACTIVE' | 'INACTIVE' — Status of the ad. Defaults to ACTIVE.
  - `media_type` 'ALL' | 'IMAGE' | 'VIDEO' | 'MEME' | 'IMAGE_AND_MEME' | 'NONE' — Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.
  - `language` string — Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
  - `sort_by` 'total_impressions' | 'relevancy_monthly_grouped' — Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.
  - `start_date` string — Start date to search for. Format: YYYY-MM-DD
  - `end_date` string — End date to search for. Format: YYYY-MM-DD
  - `cursor` string — Cursor to paginate through results
  - `trim` boolean — Set to true for a trimmed down version of the response

## Response `200`

Successful response

---

[API](https://skmtc.dev/scrapecreators/apis/scrape-creators-api.md) · [All operations](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapecreators/scrape-creators-api/revisions/e9ec3dbbd8b8/schema)