Search nutra & crypto affiliate offers
search_affiliate_offersPAID ADD-ONS «Nutra» and «Crypto», sold separately (MCP comes with the annual plan of each vertical). Find Meta ads whose landing pages are nutra or crypto affiliate offers, filtered by vertical (lp_category), niche (lp_subcategory), offer (lp_product), celebrity the landing page features (lp_celebrity — names as returned by get_affiliate_celebrities), text (q) and Facebook launch date (date_from/date_to). PAGING: one call returns at most 50 rows; when has_more=true, repeat the call with the same filters and cursor=next_cursor to get the next page (new rows, never the same ones) — keep following next_cursor until has_more=false. total is the exact number of matching ads and is omitted when no exact count is available (absent total never means zero). Each row: ad_id, advertiser, landing_domain, vertical, niche, offer. Without the add-on the call is refused; a monthly «site» subscriber is told that MCP access is part of the annual plan. QUOTA: 1 MCP credit per delivered row; section rows have their own allowance — up to 500 rows per UTC day and 5 000 per UTC month per account, shared by every tool (search_ads, get_ad, get_media and the rest count the Nutra / Crypto / Web2App rows they return too), which MCP credit packs do not raise; market summaries (get_web2app_market) are outside it. PRICING: on paid plans ×1 after 500 MCP credits/month; one-time consent via accept_pricing_terms; before calling, get the maximum debit from estimate_cost (free) and tell the user.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_affiliate_offers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | free-text search in the ad | |
| limit | No | rows per page, 1-50 (default 20); page further with cursor | |
| cursor | No | next_cursor of the previous response with the same filters: returns the next page | |
| date_to | No | Facebook launch date on/before, YYYY-MM-DD | |
| date_from | No | Facebook launch date on/after, YYYY-MM-DD | |
| lp_product | No | offer (product) name as shown by this tool (OR) | |
| lp_category | No | vertical: nutra_affiliate or crypto_affiliate (OR); omitted = the verticals your annual plans open | |
| lp_celebrity | No | celebrity name exactly as returned by get_affiliate_celebrities: ads whose landing pages feature this person (OR) | |
| lp_subcategory | No | niche as vertical/niche, e.g. nutra_affiliate/weight_loss (OR) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| error | No | Present only when isError is true: machine-readable failure. The human explanation stays in content. | |
| total | No | ||
| params | No | Request parameter echo: applied = parameters that shaped this result; normalized = parameters rewritten before applying (alias, type coercion, resolved id); ignored = parameters that were accepted but NOT applied, with the reason. | |
| degraded | No | ||
| has_more | No | ||
| addon_hints | No | Add-on modules that have additional data for objects of this result (no prices, no paid values). subscription_status=active: the account has the module — use its normal path. Do not push a purchase the user did not ask about. | |
| next_cursor | No | ||
| degraded_reason | No |