Find long-running ads in a category
find_long_running_adsSamples a category or product type across the query and up to three related angles, returning up to 24 ads (default 12) with captions, hooks, run dates, delivery evidence, strength labels and cautions. For category inspiration; search_ads supports advertiser lookups and paging. One page, no cursor. Ranking uses observed delivery evidence with approximate ordering; matching is broad, and run_duration_days and still_running show each ad’s evidence. No library totals or complete coverage; run time is not proof of sales.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "find_long_running_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| angle | No | Exact angle filter from a row’s filters.angle, e.g. social_proof. Absent means no filter. | |
| buyer | No | Who pays: business_owners = owners/operators; consumers = end consumers; professionals = business buyers or practitioners; any = no buyer filter. With a buyer filter, exact matches come back in ads and unknown-profile or adjacent business buyers in a separate nearby group (at most 25% of the page); exact_count and nearby_count report each group. | |
| query | Yes | Category, product type or market in plain words, e.g. magnesium supplements. Up to 200 characters. | |
| format | No | static = image ads; video = video ads. Absent means both. | |
| audience | No | Who it targets, e.g. restaurant owners or main street business owners. Ranks stored audience, buyer label, industry and ad-copy evidence. When supplied, industry_slug is a hard constraint; inferred categories can broaden. | |
| brand_id | No | Optional brand id from list_brands. Marks rows from that brand's competitors with your_rival; narrows nothing unless tracked_rivals_only is true. | |
| hook_type | No | Exact hook filter from a row’s hook_type_filter, e.g. urgency. Absent means no filter. | |
| max_results | No | Ads per page, 1 to 24 (default 12). | |
| min_run_days | No | Only ads observed running for at least this many days (0 to 36500). | |
| competitor_id | No | Restricts results to one saved competitor: a competitor id from list_competitors. | |
| industry_slug | No | Industry slug from a row’s filters.industry_slug, e.g. fitness-software. Parent categories include their child categories; a leaf category selects that exact category. Absence permits inferred related categories. | |
| search_angles | No | Up to three related products, offers or advertiser names to sample alongside the query. Not format or hook labels. | |
| has_spoken_hook | No | true: only ads with an extracted spoken (verbal) hook. false: only ads without one. Absent means all ads. | |
| response_format | No | Output format: text (default) is readable text with image previews and links; json returns the structured rows. table is refused by Ad Library tools. | |
| facebook_page_id | No | Restricts results to one advertiser: a facebook_page_id from search_advertisers. | |
| tracked_rivals_only | No | true restricts results to ads from the brand's tracked competitors; needs brand_id. |