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.
- 价格
- $0.00188/call按供应商原价
- 成功率
- —暂无成功率数据暂无成功率数据
- 延迟 p50
- ——
- 最后验证
- 2026年10月20日实测可用
GEThttps://toolswitch.dev/v1/tools/scrapecreators.x.v1-facebook-adlibrary-company-ads?pageId=367152833370567预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
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
示例：
falsecursor字符串可选Cursor to paginate through results
示例：
AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXPpageId字符串可选The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName
示例：
367152833370567status字符串可选Status of the ad. Defaults to ACTIVE.
示例：
ACTIVEcountry字符串可选This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
示例：
ALLsort_by字符串可选Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.
示例：
total_impressionsend_date字符串可选End date to search for. Format: YYYY-MM-DD
示例：
2025-12-31language字符串可选Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
示例：
ENmedia_type字符串可选Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.
示例：
ALLstart_date字符串可选Start date to search for. Format: YYYY-MM-DD
示例：
2025-01-01companyName字符串可选The name of the company. Can either use this or pageId
示例：
Lululemon
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
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());网关接口为预览版，地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 $0.00188/call 计费，已含服务费。