# How to map the offers in a category with Adspy Adspy · Playbooks · https://www.adspy.sh/playbooks/offer-map · Updated Nov 13, 2026 This Adspy playbook is for marketers pricing a launch or a promotion. It returns the newest ads on a topic grouped by offer, from percentage off to free gifts and bundles, with counts, examples and the brands behind each. Everything it reads is included on every plan, within fair use. - Cost: Included (Everything it reads is included on every plan, within fair use) - Where: Claude, Claude Code, Codex or any remote MCP client (Through Adspy's MCP server) - Sources: Meta and Google ads (Public ad libraries, YouTube ads included; Starter reads its own source's ads, and the TikTok source has none) - Output: Newest ads grouped by offer (With counts, examples and brands) [Connect your AI](https://www.adspy.sh/sign-up?next=/app) ## The prompt > Which offers do brands put in their newest ads about protein shake: percentage off, free gifts, bundles, free trials? Group the ads by offer with a count and two examples each, and tell me which brands lean on which offer. Change topic (protein shake) for your own; the steps stay the same. Send it as it is, or ask in your own words. ## What does Adspy do, step by step? Your AI runs 3 steps with Adspy's tools. Each call is listed with its arguments and the most it can cost on the published tariff; free and included calls use no credits. ### 1. Find the newest ads Your AI searches the newest ads that contain the topic, as one exact phrase. - `search_creatives { query: "protein shake", limit: 100 }`: Included ### 2. Read the offers It reads each ad's AI tags and analysis, including the offer it shows, and groups the ads by offer. - `get_creative_analysis { hashes }`: Included ### 3. Open one offer It opens the ads with the offer you pick, from the list of offer tags. - `list_creative_tags { category: "offer_type" }`: Free - `search_creatives { query: "protein shake", tags: ["offer_type:Free Gift"] }`: Included This example: Included. Everything it reads is included on every plan, within fair use. ## What comes back? Adspy's answer arrives in the chat, with the ads, posts and figures it rests on, so you can open each one. - The newest ads on the topic, grouped by offer, with counts - Which brands lean on which offer - Two examples per offer, with their copy No sample is shown here: the library snapshot behind the other playbooks' samples cannot show this answer, and a made-up one would mislead. ## Good to know before you run it - The offer is read from what the ad shows and says: an offer only on the landing page is missed. - Counts are ads in Adspy's library, not the market's size or spend. - Starter reads its own source's ads only; the TikTok source has posts, no ads. ## Questions about this playbook ### Can I follow one brand's offers over time? Yes. Name the brand and a start date: your AI reads its ads first seen since then and groups them by offer. ### Is it included in my plan? Yes. Searching ads and reading their AI tags and analyses are included on every plan, within fair use. ## Related playbooks - [Scan a category](https://www.adspy.sh/playbooks/category-scan): Who advertises on a topic right now, the formats they use and the claims they repeat. Included. - [Plan a seasonal campaign from last year's ads](https://www.adspy.sh/playbooks/seasonal-ads): Last season's ads on an occasion like Black Friday, grouped by offer and hook, with the date each brand started. Included. - [Find ads that say your idea](https://www.adspy.sh/playbooks/ads-by-angle): The ads closest to an idea you describe in your own words, even when they never use those words. Included. ## Have a brand in mind? Add Adspy to your assistant with this URL, sign in, and ask about its ads. You need no ad account. [Connect your AI](https://www.adspy.sh/sign-up?next=/app) · Server URL: https://www.adspy.sh/mcp --- Ad research in your AI assistant: find ads, understand the creative, and keep your team's research together. Built in Rennes. For the research behind your next campaign. [Creative search](https://www.adspy.sh/features/creative-search) · [Creative analysis](https://www.adspy.sh/features/creative-analysis) · [Brand Full Analysis](https://www.adspy.sh/features/brand-full-analysis) · [Social posts](https://www.adspy.sh/features/social-posts) · [Competitor tracking](https://www.adspy.sh/features/competitor-tracking) · [All features](https://www.adspy.sh/features) · [Competitor strategy](https://www.adspy.sh/playbooks/competitor-ad-strategy) · [Lasting hooks](https://www.adspy.sh/playbooks/hooks-that-last) · [Brand comparison](https://www.adspy.sh/playbooks/compare-brands) · [Posts run as ads](https://www.adspy.sh/playbooks/posts-run-as-ads) · [All playbooks](https://www.adspy.sh/playbooks) · [Connect your AI](https://www.adspy.sh/connect) · [API docs](https://www.adspy.sh/docs/api) · [Pricing](https://www.adspy.sh/pricing) · [Good to know](https://www.adspy.sh/good-to-know) · [Comparisons](https://www.adspy.sh/compare) · [Spectrum](https://www.adspy.sh/ad-teardowns) · [About](https://www.adspy.sh/about) · [Contact](https://www.adspy.sh/contact) · [Legal notice](https://www.adspy.sh/legal) · [Terms of Sale and Service](https://www.adspy.sh/terms) · [Privacy](https://www.adspy.sh/privacy)