> ## Documentation Index > Fetch the complete documentation index at: https://docs.searchthetrend.com/llms.txt > Use this file to discover all available pages before exploring further. # 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 | — |