Facebook ad library company ads by page id or name

scrapecreators.x.v1-facebook-adlibrary-company-ads

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

Price: $0.00188/callプロバイダー原価
Success rate: —成功率データはまだありません成功率データはまだありません
Latency p50: ——
Last verified: 2026/10/20Verified working

GEThttps://toolswitch.dev/v1/tools/scrapecreators.x.v1-facebook-adlibrary-company-ads?pageId=367152833370567Preview

Uses platform quota
Synchronous response
Reads public data

パラメータ

パラメータ	型	必須	説明	例
クエリパラメータ
`trim`	真偽値	任意	Set to true for a trimmed down version of the response	`false`
`cursor`	文字列	任意	Cursor to paginate through results	`AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP`
`pageId`	文字列	任意	The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName	`367152833370567`
`status`	文字列	任意	Status of the ad. Defaults to ACTIVE.	`ACTIVE`
`country`	文字列	任意	This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.	`ALL`
`sort_by`	文字列	任意	Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.	`total_impressions`
`end_date`	文字列	任意	End date to search for. Format: YYYY-MM-DD	`2025-12-31`
`language`	文字列	任意	Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc	`EN`
`media_type`	文字列	任意	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`	文字列	任意	Start date to search for. Format: YYYY-MM-DD	`2025-01-01`
`companyName`	文字列	任意	The name of the company. Can either use this or pageId	`Lululemon`

クエリパラメータ
trim真偽値任意
Set to true for a trimmed down version of the response
例：false
cursor文字列任意
Cursor to paginate through results
例：AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP
pageId文字列任意
The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName
例：367152833370567
status文字列任意
Status of the ad. Defaults to ACTIVE.
例：ACTIVE
country文字列任意
This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
例：ALL
sort_by文字列任意
Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.
例：total_impressions
end_date文字列任意
End date to search for. Format: YYYY-MM-DD
例：2025-12-31
language文字列任意
Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
例：EN
media_type文字列任意
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文字列任意
Start date to search for. Format: YYYY-MM-DD
例：2025-01-01
companyName文字列任意
The name of the company. Can either use this or pageId
例：Lululemon

コード例

$TOOLSWITCH_KEY をコンソールで作成したキーに置き換えてください。

Preview

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());

このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。パラメータはサンプルデータです。呼び出し料金は $0.00188/call です。サービス料を含みます。