Built-in tool
Check Meta Ad Activity
Check whether a company is currently running Meta (Facebook/Instagram) ads and how much: active ad count, creative format mix, platforms, how long its longest-running ad has been live, and the creative of up to 500 of its ads.
1 creditNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| domainstring · required | string | required | Company domain to check, e.g. "gymshark.com" (a full URL is normalized). Example: |
| limitnumber · optional | number | optional | How many ads' creative to return in `ad_creatives`, from 1 to 500. Defaults to 10. This does NOT change `active_ad_count`, which is always the advertiser's full total. Ads beyond the first 30 are fetched 10 at a time and each request costs credits, so the credit price rises with this number — ask for what you need. Default: |
| statusstring · optional | string | optional | Which ads to count. Defaults to ACTIVE (ads running right now). INACTIVE and ALL also count ads that have already stopped, so `is_running_meta_ads` is null for those — the count no longer answers "advertising right now". One of: Default: |
| countrystring · optional | string | optional | Optional 2-letter country code to restrict ads to, e.g. "US". Defaults to all countries. Example: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain",
"brand_query",
"is_running_meta_ads",
"active_ad_count",
"ads_sampled",
"format_mix",
"primary_format",
"platforms",
"longest_running_ad_days",
"first_seen",
"last_seen",
"page_id",
"page_name",
"page_url",
"match_confidence",
"page_matches_domain",
"closest_unmatched_page",
"ad_creatives_truncated",
"summary"
],
"properties": {
"domain": {
"type": "string"
},
"page_id": {
"type": [
"string",
"null"
]
},
"summary": {
"type": "string"
},
"page_url": {
"type": [
"string",
"null"
]
},
"last_seen": {
"type": [
"string",
"null"
]
},
"page_name": {
"type": [
"string",
"null"
]
},
"platforms": {
"type": "array",
"items": {
"type": "string"
}
},
"first_seen": {
"type": [
"string",
"null"
]
},
"format_mix": {
"type": "object",
"additionalProperties": {
"type": "number"
}
},
"sample_ads": {
"type": "array",
"items": {
"type": "object",
"required": [
"ad_archive_id",
"url",
"is_active",
"display_format",
"platforms",
"started",
"ended",
"days_running",
"headline",
"body",
"link_description",
"cta_text",
"link_url",
"image_url",
"video_url",
"card_count"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"body": {
"type": [
"string",
"null"
]
},
"ended": {
"type": [
"string",
"null"
]
},
"started": {
"type": [
"string",
"null"
]
},
"cta_text": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"link_url": {
"type": [
"string",
"null"
]
},
"image_url": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": [
"boolean",
"null"
]
},
"platforms": {
"type": "array",
"items": {
"type": "string"
}
},
"video_url": {
"type": [
"string",
"null"
]
},
"card_count": {
"type": "number"
},
"days_running": {
"type": [
"number",
"null"
]
},
"ad_archive_id": {
"type": [
"string",
"null"
]
},
"display_format": {
"type": [
"string",
"null"
]
},
"link_description": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"default": []
},
"ads_sampled": {
"type": "number"
},
"brand_query": {
"type": "string"
},
"ad_creatives": {
"type": "array",
"items": {
"type": "object",
"required": [
"ad_archive_id",
"url",
"is_active",
"display_format",
"platforms",
"started",
"ended",
"days_running",
"headline",
"body",
"link_description",
"cta_text",
"link_url",
"image_url",
"video_url",
"card_count"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"body": {
"type": [
"string",
"null"
]
},
"ended": {
"type": [
"string",
"null"
]
},
"started": {
"type": [
"string",
"null"
]
},
"cta_text": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"link_url": {
"type": [
"string",
"null"
]
},
"image_url": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": [
"boolean",
"null"
]
},
"platforms": {
"type": "array",
"items": {
"type": "string"
}
},
"video_url": {
"type": [
"string",
"null"
]
},
"card_count": {
"type": "number"
},
"days_running": {
"type": [
"number",
"null"
]
},
"ad_archive_id": {
"type": [
"string",
"null"
]
},
"display_format": {
"type": [
"string",
"null"
]
},
"link_description": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"default": []
},
"primary_format": {
"type": [
"string",
"null"
]
},
"active_ad_count": {
"type": [
"number",
"null"
]
},
"match_confidence": {
"enum": [
"high",
"low",
"none"
],
"type": "string"
},
"is_running_meta_ads": {
"type": [
"boolean",
"null"
]
},
"page_matches_domain": {
"type": [
"boolean",
"null"
]
},
"ad_creatives_truncated": {
"type": "boolean"
},
"closest_unmatched_page": {
"anyOf": [
{
"type": "object",
"required": [
"page_id",
"page_name",
"page_url",
"active_ad_count",
"ads_sampled",
"format_mix",
"primary_format",
"platforms",
"longest_running_ad_days",
"first_seen",
"last_seen"
],
"properties": {
"page_id": {
"type": [
"string",
"null"
]
},
"page_url": {
"type": [
"string",
"null"
]
},
"last_seen": {
"type": [
"string",
"null"
]
},
"page_name": {
"type": [
"string",
"null"
]
},
"platforms": {
"type": "array",
"items": {
"type": "string"
}
},
"first_seen": {
"type": [
"string",
"null"
]
},
"format_mix": {
"type": "object",
"additionalProperties": {
"type": "number"
}
},
"ads_sampled": {
"type": "number"
},
"primary_format": {
"type": [
"string",
"null"
]
},
"active_ad_count": {
"type": [
"number",
"null"
]
},
"longest_running_ad_days": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"longest_running_ad_days": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
}
