Find sites
find_sitesFind newly launched sites matching any combination of technology, category, country, region (a state or province), distance from a place, date range and contact availability. This is the main search tool. For example: sites in the UK built with WordPress that launched this week and have a contact email, Shopify shops within 30 miles of Bristol, or new sites in Texas. Each site carries its town and region, and its distance when near is given. For counts, shares or 'which X do these sites use', call stack_breakdown instead; it answers in one call. Counts one site from the monthly allowance for each site not already returned to you this period; you may be asked to confirm before a large result is returned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| near | No | Only sites near a place: a town or city, a postcode, or 'lat,lng', e.g. Bristol. Use with radius. Sites we could not place are left out. | |
| limit | No | How many sites to return, 1-100. Default 50. | |
| since | No | Earliest LAUNCH date, YYYY-MM-DD. Use this for questions about when products launched, e.g. 'launched this week'. | |
| until | No | Latest LAUNCH date, YYYY-MM-DD. Inclusive: the whole of that day is included, so since and until set to the same date returns that one day. | |
| cursor | No | Paging token from a previous call's nextCursor. Repeat every other filter exactly as it was when the token was issued. | |
| radius | No | How far from near, e.g. 30mi or 50km (a bare number is km). From 5 to 248 miles (8 to 400 km). | |
| confirm | No | Set true to skip the cost confirmation and return the data immediately. | |
| country | No | Country as an ISO 3166-1 alpha-2 code, e.g. GB for the United Kingdom, US, DE. Country names such as 'United Kingdom' are also accepted. Country is an ESTIMATE with a confidence score, so see minCountryConfidence. | |
| regions | No | Only sites in these states, provinces or other regions, e.g. ["Texas", "Oklahoma"]. Each a name, a name and country such as 'Georgia, US', or an id such as US-TX. A site matches if it is in ANY of them. Sites we could not place are left out. | |
| category | No | Product category, e.g. ecommerce. | |
| keywords | No | Whole words to look for in a site's name, title or description, e.g. photogrammetry. Matches ANY of them; a multi-word entry is a phrase. Three characters or more, up to ten words. Combines with every other filter, so 'Stripe sites that mention photogrammetry' is technology plus keywords. The same rule create_watch uses, so a word that filters here is the word a watch would fire on. | |
| technology | No | Technology name, exactly as returned by list_technologies, e.g. wordpress. | |
| observedSince | No | Earliest date we first recorded the site, YYYY-MM-DD. Use this instead of 'since' when polling for new rows on a schedule: sites are discovered a median of 2 days (and up to about a week) after they launch, so a poller tracking 'since' never learns about them. | |
| hasContactPage | No | Only sites that have a published contact page. Needs the 'contacts' permission. | |
| includeQuality | No | Include quality bands for each site. | |
| hasContactEmail | No | Only sites that have a published contact email. Needs the 'contacts' permission. | |
| minCountryConfidence | No | Least country confidence to accept, 0 to 1. Country is estimated from the site, and scores near the 0.45 floor are weak guesses: a site whose own title says it is in Bangladesh can score 0.48 for the UK. Genuine matches usually score 0.6 or better, so pass 0.6 when the country needs to be right rather than merely likely. Every row carries its own countryConfidence too. |