Skip to main content
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). 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’.

​
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).

​
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.

​
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.

​
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.

​
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.

​
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).

​
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.

​
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’.

​
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…).

​
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).

​
get_advertiser

Full detail for ONE advertiser (Facebook page) by monitoredPageId: page metrics, weekly history, country split and its landing-page distribution.

​
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’.

​
my_saved_ads

The ads THIS USER has saved/bookmarked in SearchTheTrend.

​
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.

​
get_brand_scan_status

Status of a brand scan launched with request_brand_scan (pending → processing → completed/failed).