K-meta

API Documentations


Request parameters for API

API (application programming interface) allows you to quickly receive large volumes of data which are not encumbered by K-Meta Tool interface. To get your API key, you'll need to subscribe to one of these plans: LITE, BASIC, PLUS - k-meta.com/pricing.html and then just go to your profile page.

Once you get your API key you can start integrating with K-Meta API. Below you will find which reports you can request and which columns, parameters, values, sortings and filters you can use. Concerning quantity of queries per second - it is easy to provide 1 query per second or 10 queries per second - but no more than 60 queries per minute and no more than 3600 queries per day - as you choose.

Endpoint: http://api.k-meta.com/


Domain Organic Research

This report lists keywords that bring users to a domain via Google's top 20 organic search results.


Parameter Mandatory Default Explanation
api_key + Required field. An identification key assigned to a user after subscribing to K-Meta that is available via Profile page.
type + 'domain_organic' - search by domain in organic serp. A type of report
query + A unique name of a website you’d like to investigate.
mode withoutSbd url type: ['exactUrl', 'prefix', 'withSbd', 'withoutSbd']
row_limit The maximum possible number of results, due to the subscription plan. The number of results in SERP The number of results returned to a request; if parameter is not specified or equal to 0, default value will be 10,000 lines.
negative_keywords keword1,...,keword30 negative keywords array
sort_by traffic ['position', 'CPC', 'competition', 'AvgMonSearches', 'impressions', 'traffic', 'totalResults', 'date', 'nwords']
This parameter allows you to choose by which column you would like to sort your results
sort_order desc sort order, 'asc' - ascending, 'desc' - descending order
include_fields all fields

Required fields must be sent in array; if this parameter is not specified, all fields will be sent.

For organic SERP -
['key', 'competition', 'avg_mon_searches', 'cost_per_click', 'traffic', 'updated', 'position', 'title', 'url', 'domain', 'snippet', 'total_results', 'visible_url', 'previous_position', 'previous_update']


Example API Domain organic search

Request:
http://api.k-meta.com/?api_key={your_api_key}&type=domain_organic&query=www.ebay.com&row_limit=10
  
Response:
<?xml version="1.0" encoding="UTF-8"?>
<root>
	<totalResults>12244697</totalResults>
	<keyresults>
		<key0>
			<key>ebay</key>
			<competition>5</competition>
			<avg_mon_searches>45500000</avg_mon_searches>
			<cost_per_click>1.33</cost_per_click>
			<traffic>7.8</traffic>
			<updated>12 May 2016</updated>
			<position>1</position>
			<url>http://www.ebay.com/</url>
			<domain>www.ebay.com</domain>
			<trends>
				<Feb>45500000</Feb>
				<Mar>45500000</Mar>
				<Apr>45500000</Apr>
				<May>45500000</May>
				<Jun>45500000</Jun>
				<Jul>45500000</Jul>
				<Aug>45500000</Aug>
				<Sep>45500000</Sep>
				<Oct>45500000</Oct>
				<Nov>45500000</Nov>
				<Dec>45500000</Dec>
				<Jan>45500000</Jan>
			</trends>
			<total_results>146000000</total_results>
			<title>&lt;b&gt;eBay:&lt;/b&gt; Electronics, Cars, Fashion, Collectibles, Coupons and More</title>
			<snippet>Buy and sell electronics, cars, fashion apparel, collectibles, sporting goods, digital cameras, baby items, coupons, and everything else on &lt;b&gt;eBay,&lt;/b&gt; the world's ...</snippet>
			<visible_url>www.ebay.com/</visible_url>
			<previous_position>1</previous_position>
			<previous_update>29 Feb 2016</previous_update>
		</key0>
		<key1>
			<key>ebay#</key>
			<competition>0</competition>
			<avg_mon_searches>45500000</avg_mon_searches>
			<cost_per_click>0.31</cost_per_click>
			<traffic>7.8</traffic>
			<updated>05 May 2016</updated>
			<position>1</position>
			<url>http://www.ebay.com/</url>
			<domain>www.ebay.com</domain>
			<trends>
				<Feb>1830000</Feb>
				<Mar>2240000</Mar>
				<Apr>1830000</Apr>
				<May>2240000</May>
				<Jun>1830000</Jun>
				<Jul>2240000</Jul>
				<Aug>2240000</Aug>
				<Sep>1830000</Sep>
				<Oct>1830000</Oct>
				<Nov>1830000</Nov>
				<Dec>1830000</Dec>
				<Jan>2240000</Jan>
			</trends>
			<total_results>450000000</total_results>
			<title>&lt;b&gt;eBay:&lt;/b&gt; Electronics, Cars, Fashion, Collectibles, Coupons and More</title>
			<snippet>Buy and sell electronics, cars, fashion apparel, collectibles, sporting goods, digital cameras, baby items, coupons, and everything else on &lt;b&gt;eBay,&lt;/b&gt; the world's ...</snippet>
			<visible_url>www.ebay.com/</visible_url>
			<previous_position>1</previous_position>
			<previous_update>29 Feb 2016</previous_update>
		</key1>

		...
		
		<key9>
			<key>ebay/com</key>
			<competition>13</competition>
			<avg_mon_searches>1220000</avg_mon_searches>
			<cost_per_click>0.75</cost_per_click>
			<traffic>0.21</traffic>
			<updated>12 May 2016</updated>
			<position>1</position>
			<url>http://www.ebay.com/</url>
			<domain>www.ebay.com</domain>
			<trends>
				<Feb>90500</Feb>
				<Mar>90500</Mar>
				<Apr>135000</Apr>
				<May>110000</May>
				<Jun>90500</Jun>
				<Jul>90500</Jul>
				<Aug>110000</Aug>
				<Sep>110000</Sep>
				<Oct>110000</Oct>
				<Nov>110000</Nov>
				<Dec>110000</Dec>
				<Jan>90500</Jan>
			</trends>
			<total_results>69200000</total_results>
			<title>eBay: Electronics, Cars, Fashion, Collectibles, Coupons and More</title>
			<snippet>Buy and sell electronics, cars, fashion apparel, collectibles, sporting goods, digital cameras, baby items, coupons, and everything else on eBay, the world's ...</snippet>
			<visible_url>www.ebay.com/</visible_url>
			<previous_position>1</previous_position>
			<previous_update>29 Feb 2016</previous_update>
		</key9>
	</keyresults>
</root>

Domain Paid Research

This report lists keywords that fetch visitors to a domain via Google's paid search results.


Parameter Mandatory Default Explanation
api_key + Required field. An identification key assigned to a user after subscribing to K-Meta that is available via Profile page.
type + 'domain_ads' - search by domain in ads serp. A type of report
query + A unique name of a website you’d like to investigate.
mode withoutSbd url type: ['exactUrl', 'prefix', 'withSbd', 'withoutSbd']
row_limit The maximum possible number of results, due to the subscription plan The number of results in SERP. The number of results returned to a request; if parameter is not specified or equal to 0, default value will be 10,000 lines.
negative_keywords keword1,...,keword30 negative keywords array
ads_type This value filter results by type of ads: 'only_PLAs' - only merchant ads SERP, 'without_PLAs' - without merchant
sort_by traffic ['position', 'CPC', 'competition', 'AvgMonSearches', 'impressions', 'traffic', 'totalResults', 'date', 'nwords']
This parameter allows you to choose by which column you would like to sort your results
sort_order desc sort order, 'asc' - ascending, 'desc' - descending order
include_fields all fields

Required fields must be sent in array; if this parameter is not specified, all fields will be sent.

For Ads SERP -
['key', 'competition', 'avg_mon_searches', 'cost_per_click', 'traffic', 'updated', 'block', 'position', 'title', 'url', 'domain', 'snippet', 'visible_url', 'phone_num', 'price', 'shop_name', 'shop_snippet', 'snippet_tags', 'sitelinks', 'snippet_ratings', 'snippet_g_plus', 'stars']


Example API Domain ads search

Request:
http://api.k-meta.com/?api_key={your_api_key}&type=domain_ads&query=www.ebay.com&row_limit=10
  
Response:
<?xml version="1.0" encoding="UTF-8"?>
<root>
	<totalResults>5601179</totalResults>
	<keyresults>
		<key0>
			<key>ebay motors</key>
			<competition>4</competition>
			<avg_mon_searches>224000000</avg_mon_searches>
			<cost_per_click>0.11</cost_per_click>
			<traffic>12.131</traffic>
			<updated>01 Mar 2016</updated>
			<position>1</position>
			<url>http://www.ebay.com/sch/motors?clk_rvr_id=986679322011&amp;_trksid=m270.l1313&amp;adpos=none&amp;crlp=66358633388_2092015&amp;MT_ID=8&amp;device=c&amp;keyword=0211_motors&amp;geo_id=10232&amp;_fromfsb=0&amp;crdt=0</url>
			<domain>www.ebay.com</domain>
			<block>Top</block>
			<trends>
				<Feb>165000</Feb>
				<Mar>201000</Mar>
				<Apr>165000</Apr>
				<May>201000</May>
				<Jun>201000</Jun>
				<Jul>246000</Jul>
				<Aug>246000</Aug>
				<Sep>246000</Sep>
				<Oct>246000</Oct>
				<Nov>450000</Nov>
				<Dec>450000</Dec>
				<Jan>201000</Jan>
			</trends>
			<title>ebay.com - &lt;b&gt;Motors&lt;/b&gt; on &lt;b&gt;eBay&lt;/b&gt; - Huge selection of &lt;b&gt;Motors&lt;/b&gt;</title>
			<snippet>Free Shipping available. Buy Now!</snippet>
			<visible_url>www.ebay.com/</visible_url>
			<snippet_tags>Brands: BMW, Chevrolet, Dodge, Ford, Honda, Jeep, Mercedes-Benz, Toyota…</snippet_tags>
		</key0>
		<key1>
			<key>iphone 5c</key>
			<competition>97</competition>
			<avg_mon_searches>55000000</avg_mon_searches>
			<cost_per_click>1.42</cost_per_click>
			<traffic>2.403</traffic>
			<updated>12 Feb 2016</updated>
			<position>1</position>
			<url>http://www.ebay.com/ulk/itm/like/161726518517?lpid=82&amp;chn=ps</url>
			<domain>www.ebay.com</domain>
			<block>Side PLAs (Product Listing Ads Positions)</block>
			<trends>
				<Feb>110000</Feb>
				<Mar>135000</Mar>
				<Apr>135000</Apr>
				<May>135000</May>
				<Jun>110000</Jun>
				<Jul>110000</Jul>
				<Aug>110000</Aug>
				<Sep>110000</Sep>
				<Oct>135000</Oct>
				<Nov>110000</Nov>
				<Dec>90500</Dec>
				<Jan>110000</Jan>
			</trends>
			<title>Apple Iphone 5c 8gb 16gb 32gb (factory Unlocked) T-mobile Straight</title>
			<price>$139.95</price>
			<shop_name>eBay</shop_name>
		</key1>

		...

		<key9>
			<key>droid maxx</key>
			<competition>66</competition>
			<avg_mon_searches>6050000</avg_mon_searches>
			<cost_per_click>0.36</cost_per_click>
			<traffic>0.264</traffic>
			<updated>17 Feb 2016</updated>
			<position>1</position>
			<url>http://www.ebay.com/ulk/itm/like/141810464110?lpid=82&amp;chn=ps</url>
			<domain>www.ebay.com</domain>
			<block>Side PLAs (Product Listing Ads Positions)</block>
			<trends>
				<Feb>33100</Feb>
				<Mar>74000</Mar>
				<Apr>90500</Apr>
				<May>49500</May>
				<Jun>74000</Jun>
				<Jul>135000</Jul>
				<Aug>110000</Aug>
				<Sep>49500</Sep>
				<Oct>33100</Oct>
				<Nov>110000</Nov>
				<Dec>135000</Dec>
				<Jan>60500</Jan>
			</trends>
			<title>Motorola Droid Maxx Xt1080m 16gb Red (verizon) Smartphone Gsm Unlocked</title>
			<price>$99.99</price>
			<shop_name>eBay</shop_name>
		</key9>
	</keyresults>
</root>

K-Bases Research

This report displays keywords parameters and keyword ideas from our keyword databases.


Parameter Mandatory Default Explanation
api_key + Required field. An identification key assigned to a user after subscribing to K-Meta that is available via Profile page.
type + 'k-bases' - search keywords in k-bases. A type of report
country + Get keywords from this country.
['United States', 'Germany', 'France', 'Canada', 'Australia', 'Japan', 'Spain', 'India', 'Denmark', 'Turkey', 'Netherlands', 'Poland', 'Ukraine', 'Sweden', 'Italy', 'Vietnam', 'Singapore', 'Czechia', 'Israel', 'Russia', 'Austria', 'Thailand', 'Indonesia', 'Brazil', 'Norway', 'Hong Kong', 'New Zealand', 'Mexico']
query + Keywords to investigate. You should use POST requests for batch collection of keyword parameters
row_limit The maximum possible number of results, due to the subscription plan.
sort_by Sort by relevance in descending order. ["", "avg-monthly-searches", "cpc", "competition", "impressions"]
This parameter allows you to choose by which column you would like to sort your results. If empty string - sort by relevance
sort_order desc sort order, 'asc' - ascending, 'desc' - descending order

Example API K-bases search

Request:
http://api.k-meta.com/?api_key={your_api_key}&type=k-bases&query=restaurants+toronto&country=Canada&row_limit=10
Response:
<?xml version="1.0" encoding="UTF-8"?>
<root>
	<exactMatch>
		<baseTotalResults>1</baseTotalResults>
		<basesResults>
			<key0>
				<keyword>restaurants toronto</keyword>
				<competition>2</competition>
				<avg_monthly_searches>10K – 100K</avg_monthly_searches>
				<cpc>1.64</cpc>
				<impressions>260000</impressions>
			</key0>
		</basesResults>
	</exactMatch>
	<substringMatch>
		<baseTotalResults>154026</baseTotalResults>
		<basesResults>
			<key0>
				<keyword>restaurants toronto</keyword>
				<competition>2</competition>
				<avg_monthly_searches>10K – 100K</avg_monthly_searches>
				<cpc>1.64</cpc>
				<impressions>260000</impressions>
			</key0>
			<key1>
				<keyword>japanese restaurants toronto</keyword>
				<competition>1</competition>
				<avg_monthly_searches>100 – 1K</avg_monthly_searches>
				<cpc>0</cpc>
				<impressions>40000</impressions>
			</key1>

			...

			<key9>
				<keyword>restaurants in toronto ontario</keyword>
				<competition>10</competition>
				<avg_monthly_searches>10 – 100</avg_monthly_searches>
				<cpc>2.97</cpc>
				<impressions>2880</impressions>
			</key9>
		</basesResults>
	</substringMatch>
</root>

Possible errors


Error name
ERROR Auth fail: Auth fail
ERROR Reached limit: You have reached your limit for today. Feel free to check back tomorrow!
ERROR Type not set: Parameter "type" doesn't set
ERROR Invalid parameter type: Invalid parameter's "type" value
ERROR Invalid parameter mode: Invalid parameter "mode"
ERROR Invalid parameter query: Invalid parameter's "query" value
ERROR Invalid parameter row_limit: Invalid parameter's "row_limit" value
ERROR Invalid parameter ads_type: Invalid parameter "ads_type"
ERROR Invalid parameter sort_by: Invalid parameter "sort_by"
ERROR Invalid parameter sort_order: Invalid parameter "sort_order"
ERROR Invalid parameters: Invalid parameters
ERROR Invalid request: Invalid request
ERROR No results found: No results found
ERROR Service is busy: Service is busy right now
ERROR Invalid parameter country: Invalid parameter "country"
ERROR Invalid parameter domains: Invalid parameter's "domains" value
ERROR Invalid parameter kword: Invalid "kword" value