Usage

The DomainLeads API offers two distinct search modes. Both authenticate the same way (using your EstiBot api key and email), but each one searches a different database and returns a different kind of result, so pick the mode that matches what you are actually looking for.

• Web Site & Domain Search (a=search) - searches our index of live web sites. Your keywords are matched against each site's title and page metadata (and, when scope=domain is used, against the domain name itself). Every result is a registered domain returned with a rich profile of web site and WHOIS data - title, meta description, language, registrar, create/expire dates, registrant details, hosting/DNS, traffic rank, social profiles and more. Use this mode when you want to find developed web sites about a topic and pull their full details.
• SLD Search (a=search_sld) - searches only the SLD, the second-level domain (the part of the name to the left of the dot, e.g. the "insurance" in insurance.com). It does not look at site content, titles or metadata at all. Every result is a matching SLD together with the list of TLD extensions already registered for it. Use this mode when you care about the name itself - keyword/brandable name research and extension availability - rather than the web site behind it.

Each mode, along with its parameters and example queries, is documented below.

Mode 1 - Web Site & Domain Search (a=search)

This mode searches live web sites by keyword. By default your keywords are matched against site titles and page metadata, and each result comes back as a registered domain with its full web site and WHOIS profile. Advanced filtering and sorting for this mode is not supported at this time but will be made available shortly.

• a - this is the action flag and it should be set to a=search
• k - your api key. you can obtain this key from your EstiBot Account Settings screen.
• email - the email account you registered on EstiBot.com
• s - this is the keyword you are searching, for example 'insurance' or 'ice+cream+shop'.
• optional count=1 - if you only want the count of results, and not the actual results list

The query below will perform a search on "ice cream shop" and return the maximum number of results allowed by your account:

The query below will perform a search on "ice cream shop" and return just the count of records found:

Mode 1 - Domain Name Searches (a=search with scope=domain)

Adding scope=domain keeps you in Mode 1 but changes what is matched: instead of searching site titles and metadata, your keywords are matched against the domain name itself (not the web site content). Results are still returned with the full web site + WHOIS profile.

The query below will perform a search on "ice cream shop" within a domain (not web site) and return the maximum number of results allowed by your account:

The query below will perform a search on "ice cream shop" within a domain (not web site) and return just the count of records foundt:

Mode 2 - SLD Search (a=search_sld)

This mode runs against the same SLD index used by our SLD Search tool. Unlike Mode 1, it does not look at web sites, titles or metadata - it matches your keyword against the SLD only (the part of the name before the dot). Rather than returning web site profiles, each result is a matching second-level domain along with the extensions that are already registered for it, plus optional developed-extension and domain-count data. Set the action flag to a=search_sld to use this mode.

• a - set this to a=search_sld to perform an SLD search
• k - your api key. you can obtain this key from your EstiBot Account Settings screen.
• email - the email account you registered on EstiBot.com
• s - the keyword you are searching, for example 'insurance' or 'ice+cream'. up to 5 words, each 2-75 characters.
• optional count=1 - if you only want the count of matching SLDs, and not the actual results list
• optional match_type - one of: contains (default), starts, ends, exact
• optional exclude_keyword - space separated keyword(s) to exclude from results
• optional exclude_numbers=1 - exclude SLDs containing numbers
• optional exclude_dashes=1 - exclude SLDs containing dashes
• optional exclude_letters=1 - exclude SLDs containing letters
• optional developed=1 - only return SLDs that have at least one developed extension
• optional min_length / max_length - filter results by SLD length
• optional sort - one of: extensions_taken (default), ext_count_dev
• optional sort_dir - one of: desc (default), asc

The query below will perform an SLD search on "insurance" and return the matching second-level domains:

The query below will perform the same SLD search but return just the count of matching SLDs:

The query below shows the optional filters in use - SLDs starting with "insurance", no numbers, between 3 and 15 characters, sorted by the number of taken extensions:

• Powered by: