EstiBot.com

API

The EstiBot API allows you to programatically query our system to obtain domain name information in a normalized JSON format.

The API is available to Expert customers only. Queries made to the API are treated the same way as queries executed on the web site and will result in your query counters being incremented.

The following tools currently support API queries:

Appraise - Domain name appraisal.
Lead Generator - End user lead generator tool.
Drops - Drop lists and auctioning domains.
Zone Difference - Daily zone file changes.

Need to access to more data such as whois, word parsing, trademark analysis or over 100 API calls? Check out our sister sites DomainPlex for enterprise API services or domainIQ.com for whois API services.

Example Queries

The section below provides example queries as well as the expected JSON responses. If you are logged in your API key is automatically populated in the examples below.

Standard Request Format

A request must have the following components in order to be valid:

k - This is your API key.
a - This is the tool you are accessing. Valid options include appraise or lead.
d - This is the data you are processing, usually a domain or keyword. Multiple items can be delimited with >>, for example test.com>>fun.com>>cars.com

Optional query parameters:

t - Query type indicating whether data should be live, cache or auto. Only applicable on appraise API calls. For fastest response times use cache type. Default is auto.

A sample API query to appraise the domain "test.com" with your API key (if you are logged in) is provided below:

Standard Response Format

All query responses will result in a JSON response object that follows an identical format. The response object format is provided below:

success - True/False status code indicating if the query succeeded or failed. True indicate query succeeded and False indicates query failed.
message - Error message if the query failed. Blank/NULL if query did not fail.
results - Object containing a summary of the results as well as the results.
results.cache - Boolean indicating whether this was a cached query.
results.bulk - Boolean indicating whether this was a bulk query (bulk is defined as >1 items).
results.item_count - Total number of results in the results.data object.
results.result_count - Total number of results in the results.data object.
results.data - Object array containing the results.
results.not_found - Object array containing a list of items not found in the cache (when query type is cache and there were domains that did not exist in cache). For example, if you appraised a019294858.com and specified cache mode only and if this domain is not in cache it would be in this array.

Sample JSON response to the above referenced appraise API call (with JSON parsed):

{
  "success": true,
  "message": "",
  "results": [{
    "id": "1195959",
    "domain": "test.com",
    "sld": "test",
    "tld": "com",
    "words": "test",
    "appraised_value": "574368",
    "appraised_wholesale_value": "34124",
    "appraised_monetization_value": "0",
    "appraised_ignore_tm_value": "574368",
    "appraised_no_sales_value": "573368",
    "appraisal_data_source_id": "1",
    "price_range_retail": "22",
    "price_range_no_tm": "22",
    "is_cctld": "0",
    "is_ntld": "0",
    "is_adult": "0",
    "is_reversed": "0",
    "language": "en",
    "language_probability": "100.00",
    "category": "Education",
    "category_root": "Education",
    "classification_id": "0",
    "first_word": "test",
    "second_word": "",
    "num_words": "1",
    "num_hyphens": "0",
    "num_numbers": "0",
    "sld_length": "4",
    "com_taken": "1",
    "net_taken": "1",
    "org_taken": "1",
    "biz_taken": "1",
    "us_taken": "1",
    "info_taken": "1",
    "extensions_taken": "6",
    "sld_extensions_taken": null,
    "search_results_phrase": "100000000",
    "search_ads_phrase": "2",
    "search_results_sld": "100000000",
    "search_ads_sld": "2",
    "search_results_reverse_phrase": "-1",
    "serp_source_phrase": "2",
    "serp_source_sld": "-1",
    "keyword_locale": "1:1",
    "keyword_exact_keyword": "[test]",
    "keyword_exact_competition": "100",
    "keyword_exact_cpc": "0.69",
    "keyword_exact_global_search_volume": "9140000",
    "keyword_exact_local_search_volume": "2740000",
    "keyword_exact_month": "5",
    "keyword_broad_keyword": "test",
    "keyword_broad_competition": "100",
    "keyword_broad_cpc": "0.69",
    "keyword_broad_global_search_volume": "5000000",
    "keyword_broad_local_search_volume": "45500000",
    "keyword_broad_month": "4",
    "keyword_ng_locale": "1:1",
    "keyword_ng_exact_keyword": "[test]",
    "keyword_ng_exact_competition": "1",
    "keyword_ng_exact_cpc": "2.51",
    "keyword_ng_exact_global_search_volume": "4090000",
    "keyword_ng_exact_local_search_volume": "550000",
    "keyword_ng_exact_month": "5",
    "keyword_ng_broad_keyword": "test",
    "keyword_ng_broad_competition": "20",
    "keyword_ng_broad_cpc": "1.97",
    "keyword_ng_broad_global_search_volume": "226000000",
    "keyword_ng_broad_local_search_volume": "45500000",
    "keyword_ng_broad_month": "3",
    "sld_ng_exact_keyword": "[test]",
    "sld_ng_exact_competition": "1",
    "sld_ng_exact_cpc": "2.51",
    "sld_ng_exact_global_search_volume": "4090000",
    "sld_ng_exact_local_search_volume": "550000",
    "sld_ng_broad_keyword": "test",
    "sld_ng_broad_competition": "20",
    "sld_ng_broad_cpc": "1.97",
    "sld_ng_broad_global_search_volume": "226000000",
    "sld_ng_broad_local_search_volume": "45500000",
    "tld_ng_exact_keyword": "[test.com]",
    "tld_ng_exact_competition": "35",
    "tld_ng_exact_cpc": "1.44",
    "tld_ng_exact_global_search_volume": "3600",
    "tld_ng_exact_local_search_volume": "1000",
    "keyword_root_ntld_ng_keyword": null,
    "keyword_root_ntld_ng_competition": "-1",
    "keyword_root_ntld_ng_cpc": "-1.00",
    "keyword_root_ntld_ng_global_search_volume": "-1",
    "keyword_root_ntld_ng_local_search_volume": "-1",
    "keyword_root_ntld_og_keyword": null,
    "keyword_root_ntld_og_competition": "-1",
    "keyword_root_ntld_og_cpc": "-1.00",
    "keyword_root_ntld_og_global_search_volume": "-1",
    "keyword_root_ntld_og_local_search_volume": "-1",
    "keyword_exact_ntld_ng_keyword": null,
    "keyword_exact_ntld_ng_competition": "-1",
    "keyword_exact_ntld_ng_cpc": "-1.00",
    "keyword_exact_ntld_ng_global_search_volume": "-1",
    "keyword_exact_ntld_ng_local_search_volume": "-1",
    "whois_create_date": "1997-06-18",
    "whois_expire_date": "2019-06-17",
    "whois_update_date": "2017-04-18",
    "whois_registrar": "NETWORK SOLUTIONS",
    "whois_registrar_iana": "2",
    "whois_reg_name": "PRIVATE",
    "whois_reg_org": "PRIVATE",
    "whois_reg_email": "DV5TV6EE2Z7@NETWORKSOLUTIONSPRIVATEREGISTRATION.COM",
    "whois_reg_email_count": null,
    "whois_is_private": "1",
    "alexa_traffic_rank": "42796",
    "alexa_reach_3m": "-1",
    "alexa_link_popularity": "0",
    "overture_tld": "1093",
    "overture_sld": "126711",
    "overture_term": "126711",
    "word_tracker_sld": "7315",
    "word_tracker_term": "7315",
    "pagerank": "0",
    "pagerank_real": "-1",
    "has_letters": "1",
    "has_numbers": "0",
    "has_only_letters": "1",
    "has_only_numbers": "0",
    "has_trademark": "0",
    "has_udrp_wipo": "0",
    "has_bad_ending": "0",
    "trademark_type": "",
    "trademark_term": "",
    "trademark_company": "",
    "trademark_risk": "0",
    "trademark_probability": "0",
    "trademark_domains": "0",
    "trademark_penalized": "0",
    "monetization_hits": "-1",
    "monetization_clicks": "-1",
    "monetization_searches": "-1",
    "monetization_revenue": "-1.000",
    "monetization_days_parked": "-1",
    "monetization_daily_avg_hits": "-1.000",
    "monetization_daily_avg_revenue": "-1.000",
    "web_pages": "1",
    "web_links_internal": "0",
    "web_links_external": "0",
    "web_links_external_unique": "0",
    "site_language": "en",
    "site_status": "1",
    "backlinks": "-1",
    "backlinks_unique": "-1",
    "backlink_ips": "0",
    "backlink_ips_unique": "-1",
    "backlink_subnets": "0",
    "backlink_subnets_unique": "-1",
    "altavista_link_popularity": "29400",
    "google_link_popularity": "530",
    "yahoo_link_popularity": "71420",
    "altavista_link_saturation": "-1",
    "google_link_saturation": "-1",
    "yahoo_link_saturation": "-1",
    "traffic_estimate": "0",
    "traffic_estimate_source": "metrics",
    "parking_revenue_estimate": "0.00",
    "development_revenue_estimate": "0.00",
    "end_user_buyers": "-1",
    "wayback_age": "0",
    "wayback_records": "0",
    "word_choppyness": "0",
    "unique_characters": "3",
    "unique_letters": "3",
    "words_rhyme": "0",
    "words_flow": "0",
    "pronounceability_score": "0",
    "using_sld": "0",
    "dmoz_listed": "1",
    "has_dns": "1",
    "pending_reappraisal": "0",
    "add_date": "2017-02-07 03:20:59",
    "appraisal_date": "2017-10-02 21:19:12",
    "appraiser_version": "2.5.9"
  }],
  "cache": true,
  "bulk": false,
  "item_count": 1,
  "not_found": [],
  "result_count": null
}

Live VS Cache Queries

Some tools allow you to specify whether you would like to perform a live lookup or a cached lookup using the t URL parameter.

The appraisal tool is one of the tools that supports the cache feature.

For example, a live appraisal lookup will force a refresh of all data points related to a domain and perform a new appraisal. This is a fairly time consuming process and may take up to 3 seconds per domain. A cache query would pull the most recent cached appraisal from the database and return it usually in less than 150ms. This makes a big difference when querying multiple domains since a batch query of 200 domains can take 5 minutes in live mode or 2 seconds in cache mode.

To ensure the fastest response time we recommend performing a cache lookup first, and any domains which are not found in the cache database (these are returned in the results as results.not_found array) can be looked up using the live system.

Appraise API Call

The appraise API call performs a domain appraisal and returns approximately 100 data points for every domain name queried.

Please observe the following restrictions when performing API based appraisal calls:

• Maximum 200 domains per submission. To query in batch use >> as delimiter, ex: d=test.com>>great.com
• Auto mode only works with single domain lookups. If you are performing batch lookups &t=cache or &t=live
• One query at a time. Please wait for the query to complete before sending a new query.

Appraise "test.com" using "auto" mode (auto mode will use cached data if its available and less than 30 days old or live mode if not):

Appraise "test.com" using "cache" mode. Checks recent cached for appraisal data and returns it. If the domain doesn't exist in the cache it will not be returned.

Appraise "test.com" using "live" mode. Forces live appraisal of a domain. This method is significantly slower than the cache method because all data points are refreshed.

Appraise "test.com" and "great.com" using "cache" mode. Checks recent cached for appraisal data and returns it. If the domain doesn't exist in the cache it will not be returned.

The recommended action for performing batch queries is to appraise everything in cache mode and any domain that is not found (it will be returned in the results.not_found array) should be looked up a second time in the live system.

Lead API Call

The lead API call generates a set of end-user leads for a particular domain or keyword and returns the data along with analytics.

Please observe the following restrictions when performing API based lead generation calls:

• Maximum 1 domain or keyword set per submit.
• One query at a time. Please wait for the query to complete before sending a new query.
• Be Patient. Lead generation is time consuming and resource intensive. Please allow up to 60 seconds per query.

Generate leads for "estibot.com":

Generate leads for the keyword "fast cars" and domain "fastcars.com" (both must be specified):

Drops API Call

The drops API call allows you to download drop lists programmatically.

Please observe the following restrictions when performing API based lead generation calls:

• Maximum 20 API downloads per day.
• List date cannot be before today or more than 10 days old.
• One query at a time. Please wait for the query to complete before sending a new query.
• Be Patient. All CSV files are generated in real time and may take up to 10 seconds to process.

Please note that the response is always a JSON object containing a URL to the CSV file (compressed) generated by the system.

Get most recent "raw_pendingdelete" file:

Get the AVAILABLE domain list (appraisals only) from 2 days ago:

Get the AVAILABLE domain list (complete with analytics) from 2 days ago:

Get the NAMEJET PRE-RELEASE domain list (complete with analytics) from 2 days ago:

Get the PENDINGDELETE domain list (complete with analytics) from 2 days ago:

Zone Difference API Call

The zone_diff API call allows you to download zone file differences (newly added domains, and newly expired domains) programmatically.

Please observe the following restrictions when performing API based lead generation calls:

• Maximum 25 API downloads per day.
• One query at a time. Please wait for the query to complete before sending a new query.
• Be Patient. All CSV files are generated in real time and may take up to 5 seconds to process.
• Files Expire. Temporary files generated on-demand expire after 1 hour.

Please note that the response is always a JSON object containing a URL to the CSV file (compressed) generated by the system. Files are compressed into .ZIP format.

Get most recent "new" zone file change (newly registered domains):

Get most recent "deleted" zone file change (newly expired domains):

Want to be forwarded directly to the file? Add &format=direct to the end of your query.

Get most recent "new" zone file change (newly registered domains) and get forwarded directly to the file:

Free domain appraisal and domain investment tools.

Popular

Recommended

Site Links

API

API

Example Queries