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 Research

This report lists keywords that lead users to a domain via Google's search results. The response is returned in XML.

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 keyword parameters and keyword ideas from our keyword databases. The response is returned in XML.


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.
['Argentina', 'Australia', 'Austria', 'Belgium', 'Brazil', 'Canada', 'Czechia', 'Denmark', 'Finland', 'France', 'Germany', 'Hong Kong', 'Hungary', 'India', 'Indonesia', 'Ireland', 'Israel', 'Italy', 'Japan', 'Mexico', 'Netherlands', 'New Zealand', 'Norway', 'Poland', 'Russia', 'Singapore', 'Slovakia', 'Spain', 'Sweden', 'Switzerland', 'Thailand', 'Turkey', 'Ukraine', 'United Kingdom', 'United States', 'Vietnam']
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>4</competition>
				<avg_monthly_searches>90500</avg_monthly_searches>
				<cpc>1.64</cpc>
				<impressions>260000</impressions>
			</key0>
		</basesResults>
	</exactMatch>
	<substringMatch>
		<baseTotalResults>154026</baseTotalResults>
		<basesResults>
			<key0>
				<keyword>restaurants toronto</keyword>
				<competition>4</competition>
				<avg_monthly_searches>90500</avg_monthly_searches>
				<cpc>1.64</cpc>
				<impressions>260000</impressions>
			</key0>
			<key1>
				<keyword>japanese restaurants toronto</keyword>
				<competition>3</competition>
				<avg_monthly_searches>4400</avg_monthly_searches>
				<cpc>0.92</cpc>
				<impressions>11000</impressions>
			</key1>

			...

			<key9>
				<keyword>restaurants in toronto ontario</keyword>
				<competition>2</competition>
				<avg_monthly_searches>140</avg_monthly_searches>
				<cpc>0.57</cpc>
				<impressions>2880</impressions>
			</key9>
		</basesResults>
	</substringMatch>
</root>

SERP Research

This kind of API allows to track Google search results in the HTML format. The response is returned in JSON. You can purchase access to it on SERP API pricing page.

Real Time Research

High execution priority Google SERP collection method by a single request. Runtime is 20 seconds.


Parameter Mandatory Default Explanation
api_key2 + You can get "api_key2" by contacting our support via e-mail: support@k-meta.com, after purchasing a suitable pricing plan for using our SERP API.
type + 'get_page' - for this type of request
query + query string
country + country, for examle ['United States', 'Germany']. The list of countries that will be used must be agreed in advance.
results_on_page 10 How many results should be on page, one of [ 10, 20, 50, 100 ]

Real Time Research Example

Request:
http://api.k-meta.com/?api_key2={your_api_key2}&type=get_page&query=my query&results_on_page=10&country=United States
Response:
{
  "success": true,
  "query": "my query",
  "result_string": "<hmtl>...</html>",
  "country": "United States",
  "results_on_page": 10
}

Asynchronous Bulk Research

Regular queue Google SERP collection mode executed by the array of queries. Runtime is 30 minutes.


Parameter Mandatory Default Explanation
api_key2 + You can get "api_key2" by contacting our support via e-mail: support@k-meta.com, after purchasing a suitable pricing plan for using our SERP API.
type + 'get_pages_bulk' - for this type of request
queries + array of queries
country + country, for examle ['United States', 'Germany']. The list of countries that will be used must be agreed in advance.
results_on_page 10 How many results should be on page, one of [ 10, 20, 50, 100 ]
postback_url Return URL for sending task results. If you specify this URL there will be no need to pick up tasks using Get SERP Tasks Results. We will send the result of a completed task by POST request to URL as soon as it is ready.

Asynchronous Bulk Research Example

Request:
http://api.k-meta.com/?api_key2={your_api_key2}&type=get_pages_bulk&queries[]=my query&country=United States&back_result_link={back_url}
Response:
{
  "success": true,
  "keywords_total": 10,
  "result_link": "http://api.k-meta.com/?api_key2={your_api_key2}&type=get_result&result_id=bdcba38a...919ac17b959d2cb",
  "result_id": "bdcba38a...919ac17b959d2cb",
  "country": "United States",
  "results_on_page": 10,
  "callback_url_sent": true
}
Back request:
{
  "status": "completed",
  "result_link": "http://api.k-meta.com/?api_key2={your_api_key2}&type=get_result&result_id=bdcba38a...919ac17b959d2cb",
  "result_id": "bdcba38a...919ac17b959d2cb",
  "pages_done_count": 5,
  "country": "United States"
}

Get Results

Receiving complete results requested in Bulk Research mode.


Parameter Mandatory Default Explanation
api_key2 + You can get "api_key2" by contacting our support via e-mail: support@k-meta.com, after purchasing a suitable pricing plan for using our SERP API.
type + 'get_result' - for this type of request
result_id + 'result_id' from URL received at bulk request

API SERP get result Example 1.

Request:
http://api.k-meta.com/?api_key2={your_api_key2}&type=get_result&result_id=bdcba38a...919ac17b959d2cb
Response:
{
  "status": "working",
  "country": "United States"
}

API SERP get result Example 2.

Request:
http://api.k-meta.com/?api_key2={your_api_key2}&type=get_result&result_id=bdcba38a...919ac17b959d2cb
Response:
{
  "status": "completed",
  "country": "United States",
  "result_pages": [
    {
      "keyword": "my keyword",
      "result_string": "<hmtl>...</html>",
    },
    ...
  ]
}
If the results could not be obtained, then the array "result_pages" is empty.

API SERP get result Error Example 3.

Request:
http://api.k-meta.com/?api_key2={your_api_key2}&type=get_result&result_id=bdcba38a...919ac17b959d2cb
Response:
{
  "success": false,
  "error": "Bad result"
}

Research limits

Receiving data about quantity of request limits left for the next 60 minutes


Parameter Mandatory Default Explanation
api_key2 + You can get "api_key2" by contacting our support via e-mail: support@k-meta.com, after purchasing a suitable pricing plan for using our SERP API.
type + 'requests_info' - for this type of request

API SERP get limits Example

Request:
http://api.k-meta.com/?api_key2={your_api_key2}&type=requests_info
Response:
{
  "success": true,
  "keywords_can_be_sent_in_hour": {
    "United States": 50000,
    "Germany": 10000
  }
}

Possible errors


Error number Error description
0 Auth fail
1 You have reached your limit for today. Feel free to check back tomorrow!
2 Parameter "type" doesn't set
3 Invalid parameter's "type" value
4 Invalid parameter "mode"
5 Invalid parameter's "query" value
6 Invalid parameter's "row_limit" value
7 Invalid parameter "ads_type"
8 Invalid parameter "sort_by"
9 Invalid parameter "sort_order"
10 Invalid parameters
11 Invalid request
12 No results found
13 Service is busy right now
14 Invalid parameter "country"
15 Invalid parameter's "domains" value
16 Invalid "kword" value

Error Example

Response:
<root>
  <ErrCode>Invalid request</ErrCode>
  <ErrNumber>11</ErrNumber>
</root>

This website uses cookies which are necessary for its functioning and delivering services. To find out more please read our Privacy Policy. By closing this banner, scrolling this page, clicking a link or continuing to browse otherwise, you agree to the use of cookies.