URLs - API SEOZoom

Metrics

Cost per row: 20 API units

Gets in-depth information about one or more URLs provided as input.

Request parameters

Name Value type Description

api_key

String

An identifying key assigned to SEOZoom members. The key can be found on the profile page.

db

String

Reference Country database.
possible values:
it, es, fr, de, uk

action

String

To get the general information of one or more URLs set the value of the field to metrics

url

String

One or more URLs separated by the symbol | (pipe)
Maximum number of input URLs = 30

Max no. of rows per response: 30

Requests per minute: 20

Endpoint

/urls/

Request examples

/urls/?api_key={YOUR_API_KEY}&action=metrics&url=https://www.misya.info/ricetta/carciofini-sottolio.htm|https://www.misya.info/ricetta/torta-di-mele.htm&db=it

<?php
	$curl = curl_init();
	
	curl_setopt_array($curl, array(
	  CURLOPT_URL => "<pre><code class="language-">/urls/?api_key={YOUR_API_KEY}&amp;action=metrics&amp;url=https://www.misya.info/ricetta/carciofini-sottolio.htm|https://www.misya.info/ricetta/torta-di-mele.htm&amp;db=it</code></pre>",
	  CURLOPT_RETURNTRANSFER => true,
	  CURLOPT_ENCODING => "",
	  CURLOPT_MAXREDIRS => 10,
	  CURLOPT_TIMEOUT => 0,
	  CURLOPT_FOLLOWLOCATION => true,
	  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
	  CURLOPT_CUSTOMREQUEST => "GET",
	));
	
	$response = curl_exec($curl);
	
	curl_close($curl);
	echo $response;
	
	?>

curl -X GET "<pre><code class="language-">/urls/?api_key={YOUR_API_KEY}&amp;action=metrics&amp;url=https://www.misya.info/ricetta/carciofini-sottolio.htm|https://www.misya.info/ricetta/torta-di-mele.htm&amp;db=it</code></pre>""

Response example

{
   "ResultRows":2,
   "UnitsUsed":80,
   "UnitsRemaining":579350,
   "response":[
      {
         "url":"https:\/\/www.misya.info\/ricetta\/torta-di-mele.htm",
         "total_keywords":846,
         "position_1to3":66,
         "position_4to6":286,
         "position_7to10":115,
         "page1":467,
         "page2":151,
         "page3":70,
         "page4":93,
         "page5":65,
         "extimated_traffic":21750,
         "potential_traffic":204106,
         "ads_coverage":32.83,
         "ads_total":42.699999999999996,
         "pza":39
      },
      {
         "url":"https:\/\/www.misya.info\/ricetta\/carciofini-sottolio.htm",
         "total_keywords":116,
         "position_1to3":2,
         "position_4to6":62,
         "position_7to10":9,
         "page1":73,
         "page2":17,
         "page3":10,
         "page4":13,
         "page5":3,
         "extimated_traffic":3033,
         "potential_traffic":29099,
         "ads_coverage":7.403308999999999,
         "ads_total":11.213309,
         "pza":23
      }
   ]
}

Keywords

Cost per row: 10 API units

Gets all the keywords for which a URL is currently ranked.
Only one URL can be analyzed at a time.

Request parameters

Name Value type Description

api_key

String

An identifying key assigned to SEOZoom members. The key can be found on the profile page.

db

String

Reference Country database.
possible values:
it, es, fr, de, uk

action

String

To get the keywords for which a URL is placed set the field value to keywords

url

String

A single URL for which to identify keywords

limit

Integer

Maximum number of keywords to be returned

Max no. of rows per response: 10.000

Requests per minute: 10

Endpoint

/urls/

Request examples

/urls/?api_key={YOUR_API_KEY}&action=keywords&url=https://www.misya.info/ricetta/carciofini-sottolio.htm&db=it&limit=10

<?php
	$curl = curl_init();
	
	curl_setopt_array($curl, array(
	  CURLOPT_URL => "<pre><code class="language-">/urls/?api_key={YOUR_API_KEY}&amp;action=keywords&amp;url=https://www.misya.info/ricetta/carciofini-sottolio.htm&amp;db=it&amp;limit=10</code></pre>",
	  CURLOPT_RETURNTRANSFER => true,
	  CURLOPT_ENCODING => "",
	  CURLOPT_MAXREDIRS => 10,
	  CURLOPT_TIMEOUT => 0,
	  CURLOPT_FOLLOWLOCATION => true,
	  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
	  CURLOPT_CUSTOMREQUEST => "GET",
	));
	
	$response = curl_exec($curl);
	
	curl_close($curl);
	echo $response;
	
	?>

curl -X GET "<pre><code class="language-">/urls/?api_key={YOUR_API_KEY}&amp;action=keywords&amp;url=https://www.misya.info/ricetta/carciofini-sottolio.htm&amp;db=it&amp;limit=10</code></pre>""

Response example

{
   "ResultRows":10,
   "UnitsUsed":400,
   "UnitsRemaining":579350,
   "response":[
      {
         "keyword":"carciofi sott olio",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":0,
         "extimated_traffic":605,
         "search_volume":12100,
         "jan":8100,
         "feb":9900,
         "mar":18100,
         "apr":27100,
         "may":60500,
         "jun":8100,
         "jul":2400,
         "aug":2400,
         "sep":2400,
         "oct":2900,
         "nov":3600,
         "dec":3600,
         "ppc_competitiveness":0.12,
         "cpcapprox":0.15,
         "indexed_pages":1100000,
         "KD":61,
         "KO":70,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofo sott'olio",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":0,
         "extimated_traffic":605,
         "search_volume":12100,
         "jan":12100,
         "feb":22200,
         "mar":22200,
         "apr":27100,
         "may":49500,
         "jun":8100,
         "jul":2400,
         "aug":2400,
         "sep":2400,
         "oct":2900,
         "nov":3600,
         "dec":4400,
         "ppc_competitiveness":0.93,
         "cpcapprox":0.26,
         "indexed_pages":85900,
         "KD":48,
         "KO":76,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofini sott olio",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":4,
         "last_variation":0,
         "extimated_traffic":664.29,
         "search_volume":12100,
         "jan":8100,
         "feb":9900,
         "mar":18100,
         "apr":27100,
         "may":60500,
         "jun":8100,
         "jul":2400,
         "aug":2400,
         "sep":2400,
         "oct":2900,
         "nov":3600,
         "dec":3600,
         "ppc_competitiveness":0.12,
         "cpcapprox":0.15,
         "indexed_pages":145000,
         "KD":62,
         "KO":69,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofi sott'olio",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":0,
         "extimated_traffic":405,
         "search_volume":8100,
         "jan":1300,
         "feb":1000,
         "mar":480,
         "apr":720,
         "may":2900,
         "jun":22200,
         "jul":33100,
         "aug":14800,
         "sep":9900,
         "oct":6600,
         "nov":1900,
         "dec":1300,
         "ppc_competitiveness":0.18,
         "cpcapprox":0.32,
         "indexed_pages":1330000,
         "KD":60,
         "KO":62,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofini sott'olio",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":4,
         "last_variation":0,
         "extimated_traffic":197.64,
         "search_volume":3600,
         "jan":1900,
         "feb":3600,
         "mar":6600,
         "apr":12100,
         "may":14800,
         "jun":1300,
         "jul":320,
         "aug":390,
         "sep":480,
         "oct":480,
         "nov":480,
         "dec":590,
         "ppc_competitiveness":0.17,
         "cpcapprox":0.04,
         "indexed_pages":130000,
         "KD":55,
         "KO":72,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofini sott'olio ricette",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":0,
         "extimated_traffic":80,
         "search_volume":1600,
         "jan":170,
         "feb":260,
         "mar":320,
         "apr":170,
         "may":260,
         "jun":1600,
         "jul":6600,
         "aug":4400,
         "sep":2900,
         "oct":1300,
         "nov":480,
         "dec":170,
         "ppc_competitiveness":0.12,
         "cpcapprox":0.35,
         "indexed_pages":164000,
         "KD":52,
         "KO":72,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofi sott'olio ricetta",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":0,
         "extimated_traffic":50,
         "search_volume":1000,
         "jan":90,
         "feb":110,
         "mar":260,
         "apr":1000,
         "may":3600,
         "jun":2900,
         "jul":2400,
         "aug":1300,
         "sep":590,
         "oct":320,
         "nov":170,
         "dec":170,
         "ppc_competitiveness":0.045378151260504,
         "cpcapprox":0,
         "indexed_pages":1240000,
         "KD":58,
         "KO":70,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofi sott olio ricetta",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":0,
         "extimated_traffic":44,
         "search_volume":880,
         "jan":880,
         "feb":1300,
         "mar":1900,
         "apr":2400,
         "may":2400,
         "jun":260,
         "jul":70,
         "aug":40,
         "sep":50,
         "oct":50,
         "nov":140,
         "dec":390,
         "ppc_competitiveness":0.11,
         "cpcapprox":0.1,
         "indexed_pages":1920000,
         "KD":65,
         "KO":68,
         "search_intent":"informational"
      },
      {
         "keyword":"come fare i carciofini sott olio",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":1,
         "extimated_traffic":36,
         "search_volume":720,
         "jan":320,
         "feb":590,
         "mar":880,
         "apr":1600,
         "may":3600,
         "jun":390,
         "jul":40,
         "aug":40,
         "sep":50,
         "oct":50,
         "nov":110,
         "dec":90,
         "ppc_competitiveness":0.04,
         "cpcapprox":0.05,
         "indexed_pages":151000,
         "KD":56,
         "KO":74,
         "search_intent":"informational"
      },
      {
         "keyword":"carciofini sott olio ricetta",
         "lang":"it",
         "google_ext":".it",
         "localcode":"",
         "ranking_position":5,
         "last_variation":0,
         "extimated_traffic":36,
         "search_volume":720,
         "jan":210,
         "feb":1600,
         "mar":2400,
         "apr":2400,
         "may":2400,
         "jun":260,
         "jul":70,
         "aug":70,
         "sep":10,
         "oct":50,
         "nov":40,
         "dec":50,
         "ppc_competitiveness":0.07,
         "cpcapprox":0.24,
         "indexed_pages":124000,
         "KD":61,
         "KO":69,
         "search_intent":"informational"
      }
   ]
}

Intent Gap

Cost of request: 40 API units

Cost per row: 20 API units

Gets all the keywords for which the indicated URL has a ranking deficiency compared to similar pages of organic competitors.
This feature identifies all the keywords that would be worth working on to improve the performance of the indicated page.
The feature is available for only one URL at a time.

Request parameters

Name Value type Description

api_key

String

An identifying key assigned to SEOZoom members. The key can be found on the profile page.

db

String

Reference Country database.
possible values:
it, es, fr, de, uk

action

String

To get the keyword shortage information of a URL set the value of the field to intentgap

url

String

A single URL for which to identify keywords

limit

Integer

Maximum number of rows to be returned

Max no. of rows per response: 10.000

Requests per minute: 10

Endpoint

/urls/

Request examples

/urls/?api_key={YOUR_API_KEY}&action=intentgap&url=https://www.misya.info/ricetta/carciofini-sottolio.htm&db=it&limit=100

<?php
	$curl = curl_init();
	
	curl_setopt_array($curl, array(
	  CURLOPT_URL => "<pre><code class="language-">/urls/?api_key={YOUR_API_KEY}&amp;action=intentgap&amp;url=https://www.misya.info/ricetta/carciofini-sottolio.htm&amp;db=it&amp;limit=100</code></pre>",
	  CURLOPT_RETURNTRANSFER => true,
	  CURLOPT_ENCODING => "",
	  CURLOPT_MAXREDIRS => 10,
	  CURLOPT_TIMEOUT => 0,
	  CURLOPT_FOLLOWLOCATION => true,
	  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
	  CURLOPT_CUSTOMREQUEST => "GET",
	));
	
	$response = curl_exec($curl);
	
	curl_close($curl);
	echo $response;
	
	?>

curl -X GET "<pre><code class="language-">/urls/?api_key={YOUR_API_KEY}&amp;action=intentgap&amp;url=https://www.misya.info/ricetta/carciofini-sottolio.htm&amp;db=it&amp;limit=100</code></pre>""

Response example

{
   "ResultRows":5,
   "UnitsUsed":150,
   "UnitsRemaining":579350,
   "response":[
      {
         "keyword":"ricette con carciofi sott olio",
         "search_volume":320,
         "ranking_position":19
      },
      {
         "keyword":"ricette carciofini",
         "search_volume":70,
         "ranking_position":14
      },
      {
         "keyword":"carciofini ricetta",
         "search_volume":30,
         "ranking_position":19
      },
      {
         "keyword":"conserve carciofi",
         "search_volume":10,
         "ranking_position":11
      },
      {
         "keyword":"carciofi da conservare",
         "search_volume":10,
         "ranking_position":13
      }
   ]
}