Pull competitor ads
pull_competitor_adsRead-only
Pull a brand's real running ads across Meta, Google, and LinkedIn ad libraries, deduped and sorted for streamlined competitor ad research.
Instructions
Pull a brand's real running ads across Meta / Google / LinkedIn ad libraries (deduped, sorted, right page resolved). Spends ScrapeCreators credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | 'longest_running' (default) etc. | |
| limit | No | max ads per platform (default 30) | |
| domain | No | the advertiser domain | |
| country | No | 2-letter, default 'US' | |
| platforms | No | default ['facebook']; add 'google','linkedin' | |
| companyName | No | the advertiser name |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Google results ({ads[], cursor} or {error}; null when not requested) | ||
| No | Meta results ({ads[], matched} or {error}; null when not requested) | ||
| No | LinkedIn results ({ads[], cursor} or {error}; null when not requested) |