Find ads
sightglass_find_adsSearch a library of real Meta ads and the landing pages they drive to. search is a semantic vector search, so describe the ad's angle, offer or visual style rather than one keyword. Combine it with companyIds, displayFormats, pageTypes and technologies to narrow, and with hookTypes, angleTypes, offerTags and funnelStages to filter on what the ad's creative was read as (each ad carries these in tags, null until it is read). Users say 'brands' for advertisers and 'landing pages' for site pages — map their words onto these filters. performanceScore and scoreTiers come from a transparent longevity + duplication heuristic; they are NOT spend, reach or ROAS and must never be presented as such. Returns metadata plus ready-to-view media URLs; call sightglass_get_ad for one ad's full detail, sightglass_get_site_page for the page an ad drives to. Fields the user's Replo plan doesn't include come back null and are named in that item's locked list (estimates = sales, visits and traffic); lockedCount is how many more results a higher plan shows. Say the data is on a higher plan; never estimate it yourself. Returns data only: nothing is shown to the user yet. Once you know the answer, call sightglass_show once with this call's resultId to show it as cards; the show call does not search again. Works without a Replo account: call it before asking the user to sign in.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| limit | No | Results per page: 20 by default, up to 40. Use the user's number when they give one; for more than 40, page with cursor. | |
| cursor | No | nextCursor from the previous page of this same call, to get the next page. Keep every other argument the same. | |
| search | No | Semantic search over the ad's copy, creative caption and advertiser. Describe the angle, offer or visual style you want (for example 'before and after skin results with a discount code'), not a single keyword. | |
| status | No | ||
| hookTypes | No | CSV of hook types: question,bold_claim,problem_callout,curiosity,proof_number,before_after,first_person_story,offer_first,us_vs_them,demo,audience_callout,contrarian,customer_testimonial,expert_or_celebrity,new_or_launch,product_showcase | |
| offerTags | No | CSV of offer tags: discount,bundle,subscription,trial_or_sample,gift_with_purchase,financing,free_shipping,giveaway | |
| pageTypes | No | CSV of landing-page types: offer_page,advertorial,listicle,quiz,lead_capture,homepage,pdp,collection,blog,marketplace,app_store,social_profile. The stored names product, squeeze and other still work. | |
| projectId | No | Replo project id, from list_projects: where the charge or the asset lands. Its workspace's plan applies. | |
| angleTypes | No | CSV of angle types: problem_solution,mechanism,proof,comparison,identity,founder_story,objection_handling,urgency,education,transformation,price_or_value,quality_or_craft,clean_or_non_toxic,convenience,gifting,sustainability | |
| companyIds | No | CSV of company ids. Users usually call companies 'brands'. | |
| scoreTiers | No | CSV of testing,scaling,growing,optimized,winning. These tiers come from a transparent longevity + duplication heuristic — they are NOT spend, reach or ROAS, and must never be described as such. | |
| workspaceId | No | Replo workspace id, from list_workspaces. Sets which workspace's plan applies; required when the user has more than one workspace. | |
| funnelStages | No | CSV of funnel stages: cold,warm,retargeting | |
| technologies | No | CSV of stack names on the brand's site, e.g. Shopify,Klaviyo | |
| displayFormats | No | CSV of image,video,carousel,dco,dpa,text,other |