Search brands
sightglass_search_companiesSearch Sightglass companies — what users call brands: the business behind one or more Meta advertiser pages, keyed on its domain. search is semantic, so describe the business (what it sells and to whom). Pass similarToCompanyId to find a company's nearest competitors instead. To look a brand up by its website pass domainSearch; when that finds nothing the brand is not tracked yet, so read its site or use the user's words, write one sentence on what it sells and to whom, and pass that as search: the results are tracked brands competing for the same customers. Each result carries store facts (platform, estimated monthly sales, products, employees, follower counts with 30-day change — all vendor estimates, never reported revenue), rank and rank movement by active ads, and momentum: a transparent 0-100 score whose components[].text say why a brand is growing (ad launches vs last month, active-ad change, follower growth, catalog activity, stack upgrades). Sort by momentum for who is blowing up, most_estimated_sales for the biggest, most_active_ads for who is spending. Trends come from ad start/stop dates and only cover ads Sightglass has seen. 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 by default: describe the business (what it sells, to whom), not one keyword. | |
| projectId | No | Replo project id, from list_projects: where the charge or the asset lands. Its workspace's plan applies. | |
| searchMode | No | ||
| categoryIds | No | CSV of category ids from sightglass_search_companies results; a node matches its whole subtree. | |
| workspaceId | No | Replo workspace id, from list_workspaces. Sets which workspace's plan applies; required when the user has more than one workspace. | |
| domainSearch | No | A brand's website, e.g. example.com or a full URL, to find that brand when Sightglass tracks it. | |
| activeAdsCountGte | No | ||
| similarToCompanyId | No | Find the nearest competitors of this company instead of searching. |