# Connect your AI to SearchTheTrend
Source: https://docs.searchthetrend.com/index
Plug Claude or ChatGPT into your SearchTheTrend data and research winning products, ads and competitors by just asking.
SearchTheTrend ships a remote **MCP server**. MCP is the open standard that Claude, ChatGPT and most AI assistants use to call external tools. Once connected, your assistant can search trending products, dissect any tracked brand's funnels, pull winning ad creatives with their copy, watch your saved lists, and even launch live brand scans, all in natural language.
## The 30-second version
```text theme={null}
https://searchthetrend.com/api/mcp
```
In **claude.ai** or **ChatGPT**: Settings → Connectors → *Add custom connector* → paste the URL.
Click **Connect** and log in with your SearchTheTrend account. That's it. **No API key needed.**
Then just ask:
> *"Find me 3 trending pet products in Germany and show me who advertises them."*
## Two ways to authenticate
| Path | For | How |
| ----------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **OAuth (recommended)** | claude.ai, ChatGPT, Claude Desktop | Paste the URL, click Connect, sign in. Your assistant acts as *you*: it sees your saved lists and spends your credits only after asking. |
| **API key** | Claude Code, Cursor, gemini-cli and other developer tools | Generate an `stt_...` key in [Settings → Connect your AI](https://searchthetrend.com/settings/mcp) and send it as a Bearer header. |
## What your assistant can do
* **Discover** trending products by niche, country and language, as compact cards with growth, spend and longevity.
* **Dissect competitors**: every Facebook page a brand advertises through, its funnel "door map" (product page vs advertorial vs quiz), tech stack and ad pixels.
* **Study winning ads**: creatives, copy, per-country reach and spend history, ad-rank position over time.
* **Watch your portfolio**: your saved products and ads, ready for scheduled check-ins.
* **Scan on demand**: launch a live brand scan of any store straight from chat.
Available on every paid plan. See [Limits & plans](/limits).
# Limits & plans
Source: https://docs.searchthetrend.com/limits
Allowances, credit costs and the brand-scan policy.
## Allowance
Connecting your AI is included with **every paid SearchTheTrend plan**.
| | Included |
| ------------------ | -------------------------------------- |
| Assistant requests | **10,000 per month** |
| Burst | Up to 30 requests per minute |
| Read tools | Unlimited within the monthly allowance |
The monthly counter resets on the 1st. Free accounts can't connect an assistant, so [upgrade](https://searchthetrend.com/settings/mcp) to get a key or connector.
## Credits
Read tools (search, get, history) don't cost credits. Only the monthly request allowance applies.
**Brand scans cost credits.** Launching a live scan of a brand not yet tracked costs the same as an in-app brand request. If a scan fails, the credits are refunded automatically. Buy more credits anytime from [Settings → Manage subscription → Buy credits](https://searchthetrend.com/brand?buy_credits=1).
## The giant-brand policy
Scans of large, consolidated advertisers like Nike, Zara or Gymshark are **refused without charge**. They run thousands of pure branding ads with no product-discovery value, so the scanner declines and refunds you, then points you at the fastest-growing emerging brands in the same niche instead.
## Safety
Every tool except brand scans is **read-only**. Your assistant can look but never change your account or data. Credit-spending actions always ask for your confirmation first.
# Playbooks
Source: https://docs.searchthetrend.com/playbooks/index
Copy-paste prompts that turn SearchTheTrend into your product-research analyst.
Once connected, paste any of these into your assistant. Replace the `[bracketed]` parts with a real domain, niche or product.
## Competitor X-ray
> *"Reconstruct the selling strategy of \[store domain]: its Facebook pages, funnels and best ads."*
Your assistant chains several tools (the brand's Facebook pages, its funnel door-map, its tech stack) into one analyst-grade breakdown. Real example of what comes back:
For a men's-apparel dropshipper running one hero polo:
* **One product, one machine**: \~3,300 active ads all pointing at a single Shopify product page (no advertorials). Pure volume on one winner.
* **Three advertising pages**: the brand page plus two persona pages ("Matt Johnson", "Scarlett Hayes") that multiply auction presence.
* **The scale story**: months of \~56 stable ads, then a single week of +489 new ads kicked off the ramp; peaked near 5,300 active before pruning dead variations.
* **The winning ad**: title `⭐⭐⭐⭐⭐ 4.8/5`, copy *"The Last Shirt You'll Ever Wear 💥 75% OFF Today Only"*, straight to the product page. Frozen for a year, only the video rotates.
The lesson the assistant draws: one hero product, one perfect page, scale by **creative volume** on the same concept, and localize with a per-market domain.
## Morning brief (as a scheduled task)
> *"Every morning, find the trending products in my niche targeting Germany and send me the top 3 with who advertises them and the angle they use."*
Claude's scheduled tasks run this daily and message you the result, so your research is done before you sit down.
## Portfolio watchdog
> *"Check my saved products and tell me if any of them lost more than 30% of their active ads this week."*
Uses your own saved list plus live ad-count history to give you an early warning that a winner is cooling off.
## Scan any brand from chat
> *"Scan the brand \[store domain] and when it's done, break down its selling angles."*
Launches a live scan (costs credits) of a brand not yet tracked, then analyzes it once ready. Massive consolidated advertisers (the Nike/Gymshark class) are politely refused and your credits refunded, because SearchTheTrend focuses on emerging DTC brands you can learn from.
## UGC scripts from winning ads
> *"Pull the 5 longest-running ads for \[product] and write me 3 UGC scripts based on their copy."*
Turns the copy of proven, long-running ads into fresh creative angles you can shoot.
# ChatGPT
Source: https://docs.searchthetrend.com/quickstart/chatgpt
Connect via developer mode with OAuth, no API key.
ChatGPT supports MCP connectors on Plus/Pro/Team plans with **developer mode** enabled.
**Settings → Apps & Connectors → Advanced → Developer mode**.
**Settings → Apps & Connectors → Create** (or *Add custom connector*), then paste:
```text theme={null}
https://searchthetrend.com/api/mcp
```
ChatGPT redirects you to SearchTheTrend. Sign in and approve. No API key involved.
Enable the SearchTheTrend connector in the chat's tools menu, then ask:
> *"Search winning skincare ads in Spanish and show me the 5 longest-running ones."*
ChatGPT requires connectors to be re-enabled per conversation in some plans. If tools don't fire, check the tools toggle for the current chat.
# claude.ai & Claude Desktop
Source: https://docs.searchthetrend.com/quickstart/claude
One-click connector, no API key.
Works on claude.ai (web) and the Claude desktop app. Requires a Claude plan with custom connectors (Pro or above) and a **paid SearchTheTrend plan**.
In Claude: **Settings → Connectors → Add custom connector**.
```text theme={null}
https://searchthetrend.com/api/mcp
```
Click **Connect**. A SearchTheTrend login opens: sign in with your account and approve. You'll see the permissions screen once, and access is remembered afterwards.
Start a new chat and ask:
> *"Reconstruct the selling strategy of \[any store domain you're curious about]."*
Claude loads the SearchTheTrend tools it needs per question. If a brand question doesn't pick up the connector, mention it explicitly: *"using SearchTheTrend, analyze…"*
## Scheduled tasks
Claude's scheduled tasks turn any prompt into a recurring brief. Try scheduling:
> *"Every morning, check the trending products in my niche targeting Germany and summarize the top 3 with who advertises them and the angle they use."*
# Claude Code
Source: https://docs.searchthetrend.com/quickstart/claude-code
One command with your API key.
For the Claude Code CLI (and other header-based clients), authenticate with a personal API key instead of OAuth.
In SearchTheTrend: [Settings → Connect your AI](https://searchthetrend.com/settings/mcp) → **Generate key**. Copy the `stt_...` value, which is shown once.
```bash theme={null}
claude mcp add --transport http searchthetrend https://searchthetrend.com/api/mcp \
--header "Authorization: Bearer stt_YOUR_KEY"
```
Add `--scope user` to make it available in every project.
Start a new Claude Code session and run `/mcp`. `searchthetrend` should show as connected with its tools.
Treat the key like a password: it acts as your account (saved lists, credit-spending scans). Revoke it anytime from the same settings page.
# Cursor
Source: https://docs.searchthetrend.com/quickstart/cursor
Add SearchTheTrend to Cursor's MCP config.
[Settings → Connect your AI](https://searchthetrend.com/settings/mcp) → **Generate key**.
**Cursor Settings → MCP → Add new global MCP server**, or edit `~/.cursor/mcp.json`:
```json theme={null}
{
"mcpServers": {
"searchthetrend": {
"url": "https://searchthetrend.com/api/mcp",
"headers": {
"Authorization": "Bearer stt_YOUR_KEY"
}
}
}
}
```
Restart Cursor (or toggle the server) and the SearchTheTrend tools appear in the agent's toolbox.
# Gemini CLI
Source: https://docs.searchthetrend.com/quickstart/gemini-cli
Add SearchTheTrend to gemini-cli's settings.
[Settings → Connect your AI](https://searchthetrend.com/settings/mcp) → **Generate key**.
Add to `~/.gemini/settings.json`:
```json theme={null}
{
"mcpServers": {
"searchthetrend": {
"httpUrl": "https://searchthetrend.com/api/mcp",
"headers": {
"Authorization": "Bearer stt_YOUR_KEY"
}
}
}
}
```
Run `gemini` and use `/mcp` to confirm the server is connected.
# Tools reference
Source: https://docs.searchthetrend.com/tools/reference
Every tool your assistant can call, with parameters. Generated from the live server, always in sync.
All tools are **read-only** except the two under *Actions*, which spend account credits and always ask for confirmation. Results are compact JSON designed for AI context windows (list tools cap at 25 rows).
## Products
### `search_products`
Search winning e-commerce/dropshipping products tracked from the Facebook Ad Library. Filter by free-text search (product name, store domain, advertiser), target countries (ISO-2), niche (2-level taxonomy: vertical or exact 'Vertical > Sub' leaf), ad-copy language, minimum active ads and days running. Sort by opportunity score (default), ad-count growth, estimated ad spend or longevity. Returns compact product cards with id (use get\_product for full detail). Cards include myshopifyDomain, two store domains sharing it are the SAME operator (twin stores).
| Parameter | Type | Required | Notes |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ---------------------------------------------------------------------------------- |
| `search` | string | No | Free text: product name, store domain or advertiser name |
| `countries` | array of string | No | ISO-2 country codes the ads target, e.g. \['DE','FR'] |
| `countriesOnly` | boolean | No | true = products targeting ONLY those countries |
| `niche` | `Apparel & Accessories` · `Health & Beauty` · `Home & Garden` · `Electronics` · `Baby & Toddler` · `Toys & Games` · `Sports & Outdoors` · `Pet Supplies` · `Automotive` · `Arts, Crafts & Hobbies` · `Office & School` · `Food & Beverage` · `Media & Books` · `Adult` · `Other` | No | Product vertical (taxonomy L1) |
| `subniche` | `Apparel & Accessories > Women's Clothing` · `Apparel & Accessories > Men's Clothing` · `Apparel & Accessories > Kids' & Baby Clothing` · `Apparel & Accessories > Shoes` · `Apparel & Accessories > Jewelry` · `Apparel & Accessories > Watches` · `Apparel & Accessories > Bags & Wallets` · `Apparel & Accessories > Eyewear` · `Apparel & Accessories > Hats, Belts & Scarves` · `Health & Beauty > Skincare` · `Health & Beauty > Makeup` · `Health & Beauty > Hair Care` · `Health & Beauty > Fragrance` · `Health & Beauty > Grooming & Personal Care` · `Health & Beauty > Supplements & Health Care` · `Health & Beauty > Beauty Tools & Devices` · `Health & Beauty > Oral Care` · `Home & Garden > Kitchen & Dining` · `Home & Garden > Home Decor` · `Home & Garden > Bedding & Bath` · `Home & Garden > Furniture` · `Home & Garden > Storage & Organization` · `Home & Garden > Cleaning & Laundry` · `Home & Garden > Lighting` · `Home & Garden > Garden & Outdoor` · `Home & Garden > Tools & Home Improvement` · `Electronics > Phone & Accessories` · `Electronics > Computers & Tablets` · `Electronics > Audio & Headphones` · `Electronics > Wearables & Smartwatches` · `Electronics > Cameras` · `Electronics > Smart Home` · `Electronics > TV & Audio-Video` · `Electronics > Cables & Chargers` · `Baby & Toddler > Baby Gear` · `Baby & Toddler > Feeding` · `Baby & Toddler > Diapering` · `Baby & Toddler > Nursery` · `Baby & Toddler > Baby Toys` · `Baby & Toddler > Baby Safety` · `Toys & Games > Kids' Toys` · `Toys & Games > Educational Toys` · `Toys & Games > Board Games & Puzzles` · `Toys & Games > Outdoor Play` · `Toys & Games > RC & Drones` · `Toys & Games > Collectibles` · `Sports & Outdoors > Fitness & Gym` · `Sports & Outdoors > Cycling` · `Sports & Outdoors > Camping & Hiking` · `Sports & Outdoors > Water Sports` · `Sports & Outdoors > Team Sports` · `Sports & Outdoors > Hunting & Fishing` · `Sports & Outdoors > Activewear Gear` · `Pet Supplies > Dog` · `Pet Supplies > Cat` · `Pet Supplies > Pet Health & Grooming` · `Pet Supplies > Pet Feeding` · `Pet Supplies > Small Pets & Aquatics` · `Automotive > Car Accessories` · `Automotive > Car Electronics` · `Automotive > Motorcycle` · `Automotive > Tools & Maintenance` · `Arts, Crafts & Hobbies > Craft Supplies` · `Arts, Crafts & Hobbies > Sewing & Knitting` · `Arts, Crafts & Hobbies > Painting & Drawing` · `Arts, Crafts & Hobbies > DIY Kits` · `Arts, Crafts & Hobbies > Party Supplies` · `Arts, Crafts & Hobbies > Musical Instruments` · `Office & School > Office Supplies` · `Office & School > Stationery` · `Office & School > Desk Accessories` · `Office & School > School Supplies` · `Food & Beverage > Snacks & Gourmet` · `Food & Beverage > Beverages` · `Food & Beverage > Tea & Coffee` · `Food & Beverage > Kitchen Consumables` · `Media & Books > Books` · `Media & Books > Courses & E-learning` · `Media & Books > Music` · `Media & Books > Video Games` · `Adult > Adult` | No | Exact taxonomy leaf, narrower than niche |
| `language` | string | No | ISO 639-1 language of the product's page/ad copy, e.g. 'de', 'es' |
| `minActiveAds` | integer | No | Default 1 hides dead products (0 active ads); pass 0 to include them. Default: `1` |
| `minDaysRunning` | integer | No | — |
| `maxDaysRunning` | integer | No | — |
| `sortBy` | `opportunity` · `growth7d` · `growth30d` · `adSpend` · `daysRunning` · `lastSeen` | No | Default: `opportunity` |
| `limit` | integer | No | Default: `10`. Range: 1–25 |
### `trending_products`
The products gaining active ads the FASTEST right now (7-day ad-count growth, minimum scale filter). Zero-config shortcut for 'what is trending / heating up today'.
| Parameter | Type | Required | Notes |
| --------- | ------- | -------- | -------------------------- |
| `limit` | integer | No | Default: `10`. Range: 1–25 |
### `get_product`
Full detail for ONE product by its id (from search\_products/trending\_products): metrics, score, country distribution, weekly ad-activity history and its top ads (creative URLs + copy).
| Parameter | Type | Required | Notes |
| ----------- | ------ | -------- | ----- |
| `productId` | string | Yes | — |
### `get_product_sources`
PROVENANCE / funnel strategy of a product's ads: which Facebook pages advertise it and from which store domains, with per-page ad volumes (sourceBreakdown), plus its 'door map': every distinct landing URL its ads point at, typed (product page / advertorial / lander / quiz) with volumes (landingUrls). Answers 'HOW is this product being sold and by whom', key piece when reconstructing a competitor's selling strategy.
| Parameter | Type | Required | Notes |
| ----------- | ------ | -------- | ----- |
| `productId` | string | Yes | — |
### `get_product_history`
A product's weekly ad-activity time series PARTITIONED per advertising Facebook page (who ramped up, who dropped off, when each page joined). Sum partitions for the total.
| Parameter | Type | Required | Notes |
| ----------- | ------ | -------- | ----- |
| `productId` | string | Yes | — |
## Ads
### `search_ads`
Search INDIVIDUAL Facebook ads (creatives + copy) across all tracked advertisers. Filter by free text (ad copy / advertiser), status, media type, target countries, niche (2-level taxonomy) and the language the ad copy is written in. Returns ad cards with creative URLs.
| Parameter | Type | Required | Notes |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | -------------------------------------------------- |
| `search` | string | No | — |
| `statuses` | array of `active` · `inactive` | No | — |
| `mediaTypes` | array of `image` · `video` | No | — |
| `countries` | array of string | No | — |
| `niche` | `Apparel & Accessories` · `Health & Beauty` · `Home & Garden` · `Electronics` · `Baby & Toddler` · `Toys & Games` · `Sports & Outdoors` · `Pet Supplies` · `Automotive` · `Arts, Crafts & Hobbies` · `Office & School` · `Food & Beverage` · `Media & Books` · `Adult` · `Other` | No | Ad vertical (taxonomy L1) |
| `subniche` | `Apparel & Accessories > Women's Clothing` · `Apparel & Accessories > Men's Clothing` · `Apparel & Accessories > Kids' & Baby Clothing` · `Apparel & Accessories > Shoes` · `Apparel & Accessories > Jewelry` · `Apparel & Accessories > Watches` · `Apparel & Accessories > Bags & Wallets` · `Apparel & Accessories > Eyewear` · `Apparel & Accessories > Hats, Belts & Scarves` · `Health & Beauty > Skincare` · `Health & Beauty > Makeup` · `Health & Beauty > Hair Care` · `Health & Beauty > Fragrance` · `Health & Beauty > Grooming & Personal Care` · `Health & Beauty > Supplements & Health Care` · `Health & Beauty > Beauty Tools & Devices` · `Health & Beauty > Oral Care` · `Home & Garden > Kitchen & Dining` · `Home & Garden > Home Decor` · `Home & Garden > Bedding & Bath` · `Home & Garden > Furniture` · `Home & Garden > Storage & Organization` · `Home & Garden > Cleaning & Laundry` · `Home & Garden > Lighting` · `Home & Garden > Garden & Outdoor` · `Home & Garden > Tools & Home Improvement` · `Electronics > Phone & Accessories` · `Electronics > Computers & Tablets` · `Electronics > Audio & Headphones` · `Electronics > Wearables & Smartwatches` · `Electronics > Cameras` · `Electronics > Smart Home` · `Electronics > TV & Audio-Video` · `Electronics > Cables & Chargers` · `Baby & Toddler > Baby Gear` · `Baby & Toddler > Feeding` · `Baby & Toddler > Diapering` · `Baby & Toddler > Nursery` · `Baby & Toddler > Baby Toys` · `Baby & Toddler > Baby Safety` · `Toys & Games > Kids' Toys` · `Toys & Games > Educational Toys` · `Toys & Games > Board Games & Puzzles` · `Toys & Games > Outdoor Play` · `Toys & Games > RC & Drones` · `Toys & Games > Collectibles` · `Sports & Outdoors > Fitness & Gym` · `Sports & Outdoors > Cycling` · `Sports & Outdoors > Camping & Hiking` · `Sports & Outdoors > Water Sports` · `Sports & Outdoors > Team Sports` · `Sports & Outdoors > Hunting & Fishing` · `Sports & Outdoors > Activewear Gear` · `Pet Supplies > Dog` · `Pet Supplies > Cat` · `Pet Supplies > Pet Health & Grooming` · `Pet Supplies > Pet Feeding` · `Pet Supplies > Small Pets & Aquatics` · `Automotive > Car Accessories` · `Automotive > Car Electronics` · `Automotive > Motorcycle` · `Automotive > Tools & Maintenance` · `Arts, Crafts & Hobbies > Craft Supplies` · `Arts, Crafts & Hobbies > Sewing & Knitting` · `Arts, Crafts & Hobbies > Painting & Drawing` · `Arts, Crafts & Hobbies > DIY Kits` · `Arts, Crafts & Hobbies > Party Supplies` · `Arts, Crafts & Hobbies > Musical Instruments` · `Office & School > Office Supplies` · `Office & School > Stationery` · `Office & School > Desk Accessories` · `Office & School > School Supplies` · `Food & Beverage > Snacks & Gourmet` · `Food & Beverage > Beverages` · `Food & Beverage > Tea & Coffee` · `Food & Beverage > Kitchen Consumables` · `Media & Books > Books` · `Media & Books > Courses & E-learning` · `Media & Books > Music` · `Media & Books > Video Games` · `Adult > Adult` | No | Exact taxonomy leaf, narrower than niche |
| `language` | string | No | ISO 639-1 language of the ad copy, e.g. 'de', 'es' |
| `limit` | integer | No | Default: `10`. Range: 1–25 |
### `get_ad`
Full detail of ONE ad by id or Facebook archive id: creative cards (carousel), copy, per-country reach snapshot, estimated spend, landing URL + landing type, language.
| Parameter | Type | Required | Notes |
| --------- | ------ | -------- | ------------------------------- |
| `adId` | string | Yes | Internal id or FB ad archive id |
### `get_ad_reach_history`
Per-country reach & estimated spend TIME SERIES for one ad (how a campaign scaled or died, country by country, day by day).
| Parameter | Type | Required | Notes |
| --------- | ------- | -------- | --------------------------- |
| `adId` | string | Yes | — |
| `days` | integer | No | Default: `90`. Range: 7–180 |
## Brands
### `get_brand`
Analyze / spy on a BRAND, STORE or COMPETITOR by its domain (e.g. 'lymphoria.co'), the starting point to reconstruct a competitor's selling strategy: every Facebook fan page it advertises through (many brands run 10-20 'satellite' pages), total active ads, detected tech stack (Shopify/funnel builders) and ad pixels. The competitor X-ray. Chain with search\_products(search=domain) and get\_product\_sources to map its products and funnels.
| Parameter | Type | Required | Notes |
| --------- | ------ | -------- | -------------------------------- |
| `domain` | string | Yes | Store domain or myshopify domain |
### `search_brands`
Search tracked BRANDS (stores grouped across all their fan pages). Filter by domain text, detected tech (e.g. \['shopify','funnelish','clickfunnels','gempages','replo']), ad pixels (e.g. \['meta','tiktok','snapchat','google']), dominant store language or minimum active ads. Sorted by active ads. Great for stack espionage: 'brands running funnelish with a TikTok pixel'.
| Parameter | Type | Required | Notes |
| -------------- | --------------- | -------- | ------------------------------------------------ |
| `q` | string | No | Domain contains… |
| `tech` | array of string | No | — |
| `pixels` | array of string | No | — |
| `language` | string | No | ISO 639-1 dominant language of the brand's store |
| `minActiveAds` | integer | No | — |
| `limit` | integer | No | Default: `10`. Range: 1–25 |
### `get_domain_intel`
Tech stack + ad pixels detected on a competitor store DOMAIN (even if it's not a tracked brand yet): platform (Shopify/Woo/funnel builders like ClickFunnels, Funnelish, GemPages, Replo) and pixels (Meta, TikTok, Google, GTM, Snapchat, Pinterest…).
| Parameter | Type | Required | Notes |
| --------- | ------ | -------- | ----- |
| `domain` | string | Yes | — |
## Advertisers (Facebook pages)
### `search_advertisers`
Search tracked ADVERTISERS (Facebook pages running ads). Filter by name/domain text, target countries, niche (vertical), the languages the page advertises in, or minimum product count. Returns advertiser cards with monitoredPageId (use get\_advertiser for detail).
| Parameter | Type | Required | Notes |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------------------------------------- |
| `q` | string | No | — |
| `countries` | array of string | No | — |
| `niche` | `Apparel & Accessories` · `Health & Beauty` · `Home & Garden` · `Electronics` · `Baby & Toddler` · `Toys & Games` · `Sports & Outdoors` · `Pet Supplies` · `Automotive` · `Arts, Crafts & Hobbies` · `Office & School` · `Food & Beverage` · `Media & Books` · `Adult` · `Other` | No | Page vertical (taxonomy L1) |
| `language` | string | No | ISO 639-1, pages running ads in this language |
| `minProducts` | integer | No | — |
| `limit` | integer | No | Default: `10`. Range: 1–25 |
### `get_advertiser`
Full detail for ONE advertiser (Facebook page) by monitoredPageId: page metrics, weekly history, country split and its landing-page distribution.
| Parameter | Type | Required | Notes |
| ----------------- | ------ | -------- | ----- |
| `monitoredPageId` | string | Yes | — |
## Your account
### `my_saved_products`
The products THIS USER has saved/bookmarked in SearchTheTrend. Great starting point: 'analyze my saved products and tell me which one to launch'.
| Parameter | Type | Required | Notes |
| --------- | ------- | -------- | -------------------------- |
| `limit` | integer | No | Default: `20`. Range: 1–25 |
### `my_saved_ads`
The ads THIS USER has saved/bookmarked in SearchTheTrend.
| Parameter | Type | Required | Notes |
| --------- | ------- | -------- | -------------------------- |
| `limit` | integer | No | Default: `20`. Range: 1–25 |
## Actions (cost credits)
### `request_brand_scan`
LAUNCH a live scan of a brand's Facebook Ad Library presence (scrapes all its current ads, links products, computes metrics, takes a few minutes). COSTS 300 CREDITS from the user's account, like the in-app 'brand request'. Provide EITHER a Facebook Ad Library URL or a Facebook page id. Returns a jobId, poll get\_brand\_scan\_status until finished, then use get\_brand / search\_products on the fresh data. Ask the user for confirmation before calling this.
| Parameter | Type | Required | Notes |
| ---------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `adLibraryUrl` | string | No | [https://www.facebook.com/ads/library/?...view\_all\_page\_id=…](https://www.facebook.com/ads/library/?...view_all_page_id=…) |
| `facebookPageId` | string | No | Numeric FB page id, the URL is built for you |
### `get_brand_scan_status`
Status of a brand scan launched with request\_brand\_scan (pending → processing → completed/failed).
| Parameter | Type | Required | Notes |
| --------- | ------ | -------- | ----- |
| `jobId` | string | Yes | — |