K-meta

Keyword Research Tool

Menu
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 this plans: LITE, BASIC, PLUS - k-meta.com/prices.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 - as you choose.

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


Domain Organic Search Keywords

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', 'volume', 'traffic', 'totalResults', 'date']
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', 'volume', '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=ca5ae235a63862505c6c7bebf31ec1aa&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>
			<volume>45500000</volume>
			<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>
			<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>
			<volume>45500000</volume>
			<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>
			<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>
			<volume>1220000</volume>
			<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>
			<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 Search Keywords

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', 'volume', 'traffic', 'totalResults', 'date']
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', 'volume', '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=ca5ae235a63862505c6c7bebf31ec1aa&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>
			<volume>224000000</volume>
			<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>
			<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>
			<volume>55000000</volume>
			<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>
			<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>
			<volume>6050000</volume>
			<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>
			<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 Search Keywords

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', 'Czech Republic', 'Israel', 'Russia', 'Austria', 'Thailand', 'Indonesia', 'Brazil', 'Norway', 'Hong Kong']
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=ca5ae235a63862505c6c7bebf31ec1aa&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 0: Auth fail
ERROR 1: You have reached your limit for today. Feel free to check back tomorrow!
ERROR 2: Parameter "type" doesn't set
ERROR 3: Invalid parameter's "type" value
ERROR 4: Invalid parameter "mode"
ERROR 5: Invalid parameter's "query" value
ERROR 6: Invalid parameter's "row_limit" value
ERROR 7: Invalid parameter "ads_type"
ERROR 8: Invalid parameter "sort_by"
ERROR 9: Invalid parameter "sort_order"
ERROR 10: Invalid parameters
ERROR 11: Invalid request
ERROR 12: No results found
ERROR 13: Service is busy right now
ERROR 14: Invalid parameter "country"