Facebook ad library company ads by page id or name
scrapecreators.x.v1-facebook-adlibrary-company-adsFetches all ads currently running for a specific company from the Meta Ad Library.
- Price
- $0.00188/callZum Anbieterpreis
- Success rate
- —Noch keine ErfolgsratendatenNoch keine Erfolgsratendaten
- Latency p50
- ——
- Last verified
- 20.10.2026Verified working
GEThttps://toolswitch.dev/v1/tools/scrapecreators.x.v1-facebook-adlibrary-company-ads?pageId=367152833370567Preview- Uses platform quota
- Synchronous response
- Reads public data
Parameter
| Parameter | Typ | Erforderlich | Beschreibung | Beispiel |
|---|---|---|---|---|
| Abfrageparameter | ||||
trim | Boolean | Optional | Set to true for a trimmed down version of the response | false |
cursor | Zeichenkette | Optional | Cursor to paginate through results | AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP |
pageId | Zeichenkette | Optional | The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName | 367152833370567 |
status | Zeichenkette | Optional | Status of the ad. Defaults to ACTIVE. | ACTIVE |
country | Zeichenkette | Optional | This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL. | ALL |
sort_by | Zeichenkette | Optional | Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. | total_impressions |
end_date | Zeichenkette | Optional | End date to search for. Format: YYYY-MM-DD | 2025-12-31 |
language | Zeichenkette | Optional | Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc | EN |
media_type | Zeichenkette | Optional | Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme. | ALL |
start_date | Zeichenkette | Optional | Start date to search for. Format: YYYY-MM-DD | 2025-01-01 |
companyName | Zeichenkette | Optional | The name of the company. Can either use this or pageId | Lululemon |
- Abfrageparameter
trimBooleanOptionalSet to true for a trimmed down version of the response
Beispiel:
falsecursorZeichenketteOptionalCursor to paginate through results
Beispiel:
AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXPpageIdZeichenketteOptionalThe companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName
Beispiel:
367152833370567statusZeichenketteOptionalStatus of the ad. Defaults to ACTIVE.
Beispiel:
ACTIVEcountryZeichenketteOptionalThis can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
Beispiel:
ALLsort_byZeichenketteOptionalSort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.
Beispiel:
total_impressionsend_dateZeichenketteOptionalEnd date to search for. Format: YYYY-MM-DD
Beispiel:
2025-12-31languageZeichenketteOptionalLanguage to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
Beispiel:
ENmedia_typeZeichenketteOptionalMedia type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.
Beispiel:
ALLstart_dateZeichenketteOptionalStart date to search for. Format: YYYY-MM-DD
Beispiel:
2025-01-01companyNameZeichenketteOptionalThe name of the company. Can either use this or pageId
Beispiel:
Lululemon
Codebeispiele
Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.
curl -X GET 'https://toolswitch.dev/v1/tools/scrapecreators.x.v1-facebook-adlibrary-company-ads?pageId=367152833370567' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/scrapecreators.x.v1-facebook-adlibrary-company-ads?pageId=367152833370567",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/scrapecreators.x.v1-facebook-adlibrary-company-ads?pageId=367152833370567", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Diese Gateway-API ist eine Vorschauversion; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit $0.00188/call einschließlich Servicegebühr abgerechnet.