SEO-Explorer

API Information

The API can be used to query all the data supplied by the GUI using HTTP/S requests. In order to work with the API you need to contact us at sales@seo-explorer.io to verify your usage scenario.

Allowed usage for regular accounts:

  • Internal research.
  • Internal application.
  • Use the data for offline client reports (in pdf/word document).
  • Enterprise usage that require a special account and permission:

  • Using the data on a public website.
  • Using the data in a web extension.
  • Sharing data publicly.
  • Using the data in a public application.
  • After getting our approval we will provide the token.

    The API requires a token for authorization, and can be accessed with any web aware application, the format of the request is: http://apiurl//api.php?token=token&apitype=type& specific data per request

    The return value is JSON and will always include the field responsecode with the possible values:

  • 0 - OK
  • 1 - Internal error
  • 2 - No token (the token can't be found)
  • 10 - Invalid token
  • 11 - Bad parameter
  • 12 - No credits
  • Each API call cost is different in terms of credit and is specified in each call

    This API call will return the search engine results for the requested keyword, the cost is one credit for each 10 rows of returned data, so if you requested 100 results for a keyword, the cost is 10 credits, the minimum cost is one credit

    Parameters:

  • apitype - Is set to search
  • keyword - The keyword you want to search, for unicode keywords you should encode the utf8 with base64 and use the parameter keyword64 instead.
  • maxitems (optional) - Max results to provide.
  • Example: Get 20 results for the keyword seo:

    http://apiurl/api.php?token=token&apitype=search&keyword=seo&maxitems=20
    Reply:
    {"result":[{"URL":"moz.com\/beginners-guide-to-seo"},{"URL":"searchengineland.com\/guide\/what-is-seo"},{"URL":"support.google.com\/webmasters\/answer\/7451184?hl=en"},{"URL":"neilpatel.com\/what-is-seo\/"},{"URL":"en.wikipedia.org\/wiki\/Search_engine_optimization"},{"URL":"wordstream.com\/blog\/ws\/2015\/04\/30\/seo-basics"},{"URL":"wordstream.com\/seo"},{"URL":"searchenginejournal.com\/seo-guide\/"},{"URL":"ahrefs.com\/blog\/what-is-seo\/"},{"URL":"searchenginewatch.com\/2016\/01\/21\/seo-basics-22-essentials-you-need-for-optimizing-your-site\/"},{"URL":"backlinko.com\/hub\/seo\/what-is-seo"},{"URL":"webopedia.com\/TERM\/S\/SEO.html"},{"URL":"mangools.com\/blog\/learn-seo\/"},{"URL":"redevolution.com\/what-is-seo"},{"URL":"redevolution.com\/what-is-seo"},{"URL":"blog.hubspot.com\/marketing\/what-is-seo"},{"URL":"quicksprout.com\/seo\/"},{"URL":"searchenginewatch.com\/category\/seo\/"},{"URL":"optinmonster.com\/ultimate-seo-guide\/"},{"URL":"seo.com\/"}],"total":97,"responsecode":0}

    This API call will return the search engine results for the requested keyword, the cost is one credit for volume result and one credit for classification result, if you request both, the cost is two credits

    Parameters:

  • apitype - Is set to keywordinformation
  • keyword - The keyword you want to search, for unicode keywords you should encode the utf8 with base64 and use the parameter keyword64 instead.
  • class (optional) - Set to one if you want the keyword's classification.
  • volume (set by default) - Set to zero if you don't want the search volume.
  • Example 1: Get the search volume for the keyword seo:

    http://apiurl/api.php?token=token&apitype=keywordinformation&keyword=seo
    Reply:
    {"volume":300000,"ctr":33,"difficulty":"55","adctr":1,"responsecode":0}

    The result data is:

  • volume - Montly search volume.
  • ctr - Click through rate in precentage (100 being the higest).
  • adctr - Ad Click through rate in precentage (100 being the higest).
  • Difficulty - Keyword ranking difficulty.
  • Example 2: Get the search volume for the keyword seo and classification result:

    http://apiurl/api.php?token=token&apitype=keywordinformation&keyword=seo&class=1
    Reply:
    {"volume":300000,"ctr":33,"difficulty":"55","adctr":1,"category1":"165","category2":"0","categorytext1":"SEO","categorytext2":"","responsecode":0}

    The result data is the volume data and additional:

  • category1 - Category number.
  • category2 - Additional category number.
  • categorytext1 - Text name of the category.
  • categorytext2 - Text name of the additional category.
  • Example 3: Get only the keyword's classification:

    http://apiurl/api.php?token=token&apitype=keywordinformation&keyword=seo&class=1&volume=0
    Reply:
    {"category1":"165","category2":"0","categorytext1":"SEO","categorytext2":"","responsecode":0}

    This API call will return information about the domain, the cost is one credit for domain information and one credit for classification result, if you request both, the cost is two credits

    Parameters:

  • apitype - Is set to domaininformation
  • domain - The domain you want to search.
  • class (optional) - Set to one if you want the keyword's classification.
  • data (set by default) - Set to zero if you don't want the domain information.
  • Example 1: Get the domain information for the site: ebay.com:

    http://apiurl/api.php?token=token&apitype=domaininformation&domain=ebay.com
    Reply:
    {"domainscore":"68","totalinbound":"488606","totalinboundunique":"28731","totalinboundfollow":"448993","totalinboundaffiliates":"349","totalinboundhomepage":"84944","totalinboundimage":"50492","totalinboundframe":"0","totalinboundredirect":"6960","totalinboundbad":"3542","totalinboundtext":431154,"totaloutbound":"77655","totaloutboundunique":"46","totaloutboundimage":"14","totaloutboundframe":"0","totaloutboundredirect":"3","totaloutboundbad":"0","totaloutboundtext":77638,"responsecode":0}

    The result data is:

  • domainscore - Site's domain score.
  • totalinbound - Total inbound links.
  • totalinboundunique - Total unique linking domains.
  • totalinboundfollow - Total dofollow links.
  • totalinboundaffiliates - Total affiliates links.
  • totalinboundhomepage - Total links pointing to the home page.
  • totalinboundimage - Total inbound image links.
  • totalinboundframe - Total inbound frame links.
  • totalinboundredirect - Total inbound redirect links.
  • totalinboundbad - Total inbound hidden links.
  • totalinboundtext - Total inbound text links.
  • totaloutbound - Total outbound links.
  • totaloutboundunique - Total outbound unique domains.
  • totaloutboundimage - Total outbound image links.
  • totaloutboundframe - Total outbound frame links.
  • totaloutboundredirect - Total outbound redirect links.
  • totaloutboundbad - Total outbound hidden links.
  • totaloutboundtext - Total outbound text links.
  • Example 2: Get the domain information for the site: ebay.com and classification:

    http://apiurl/api.php?token=token&apitype=domaininformation&domain=ebay.com&class=1
    Reply:
    {"domainscore":"68","totalinbound":"488606","totalinboundunique":"28731","totalinboundfollow":"448993","totalinboundaffiliates":"349","totalinboundhomepage":"84944","totalinboundimage":"50492","totalinboundframe":"0","totalinboundredirect":"6960","totalinboundbad":"3542","totalinboundtext":431154,"totaloutbound":"77655","totaloutboundunique":"46","totaloutboundimage":"14","totaloutboundframe":"0","totaloutboundredirect":"3","totaloutboundbad":"0","totaloutboundtext":77638,"category1":"67","category2":0,"categorytext1":"Shopping","categorytext2":"","responsecode":0}

    The result data is the volume data and additional:

  • category1 - Category number.
  • category2 - Additional category number.
  • categorytext1 - Text name of the category.
  • categorytext2 - Text name of the additional category.
  • Example 3: Get only the domains's classification:

    http://apiurl/api.php?token=token&apitype=domaininformation&domain=ebay.com&class=1&data=0
    Reply:
    {"category1":"67","category2":0,"categorytext1":"Shopping","categorytext2":"","responsecode":0}

    This API call will return links that have a specific requested keyword, regardless of source or target site, the cost is one credit for each 10 rows of returned data, so if you requested 100 results for a keyword, the cost is 10 credits, the minimum cost is one credit

    Parameters:

  • apitype - Is set to keywordlink
  • keyword - The keyword you want to search, for unicode keywords you should encode the utf8 with base64 and use the parameter keyword64 instead.
  • from - Starting record.
  • to - Ending record.
  • It's possible to request up to 10,000 results in one time, but for speed it's recommended to get 100 results at a time.

    Example: Get the first 5 results for the keyword seo:

    http://apiurl/api.php?token=token&apitype=keywordlink&keyword=seo&from=0&to=5
    Reply:
    {"responsecode":0,"result":[{"fromdomainscore":"0","todomainscore":"0","fromurl":"http:\/\/incubaweb.com\/5-ideas-para-conseguir-enlaces-de-calidad-a-tus-contenidos\/","fromtitle":"5 ideas para conseguir enlaces de calidad a tus contenidos - Incubaweb - software y web 2.0","tourl":"http:\/\/diariothc.com\/seo-low-cost-de-verdad-vale-la-pena\/","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/5280-postcode","fromtitle":"5280 postcode, 5280 postcode in ACT","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/5253-postcode","fromtitle":"5253 postcode, 5253 postcode in ACT","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/5253-postcode","fromtitle":"5253 postcode, 5253 postcode in ACT","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/qld-toomulla-postcode","fromtitle":"Toomulla postcode, Toomulla, Queensland postcode","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"}]}

    Example: Getting the next 5 results for the keyword seo:

    http://apiurl/api.php?token=token&apitype=keywordlink&keyword=seo&from=5&to=10
    Reply:
    {"responsecode":0,"result":[{"fromdomainscore":"0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/qld-toomulla-postcode","fromtitle":"Toomulla postcode, Toomulla, Queensland postcode","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/qld-toomulla-postcode","fromtitle":"Toomulla postcode, Toomulla, Queensland postcode","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/qld-cashmere-postcode","fromtitle":"Cashmere postcode, Cashmere, Queensland postcode","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/qld-cashmere-postcode","fromtitle":"Cashmere postcode, Cashmere, Queensland postcode","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"},{"fromdomainscore":" 0","todomainscore":"0","fromurl":"http:\/\/postcode-finders.com.au\/qld-cashmere-postcode","fromtitle":"Cashmere postcode, Cashmere, Queensland postcode","tourl":"http:\/\/emrerothzerg.com\/services\/seo","totitle":"","nofollow":0,"firstseen":"1\/Oct\/2019","lastseen":"1\/Oct\/2019"}]}

    The result data is:

  • fromdomainscore - From domain domain score.
  • todomainscore - To site domain score.
  • fromurl - From URL that provides the backlink.
  • fromtitle - From URL's title.
  • tourl - To URL that is the target of the backlink.
  • totitle - To URL's title (may be empty of page wasn't crawled yet).
  • nofollow - 0 is dofollow, 1 is nofollow.
  • lastseen - Date backlink was last seen.
  • This API call will return pages that have a specific requested keyword in their title, the cost is one credit for each 10 rows of returned data, so if you requested 100 results for a keyword, the cost is 10 credits, the minimum cost is one credit

    Parameters:

  • apitype - Is set to keywordtitle
  • keyword - The keyword you want to search, for unicode keywords you should encode the utf8 with base64 and use the parameter keyword64 instead.
  • from - Starting record.
  • to - Ending record.
  • It's possible to request up to 10,000 results in one time, but for speed it's recommended to get 100 results at a time.

    Example: Get the first 5 results for the keyword seo:

    http://apiurl/api.php?token=token&apitype=keywordtitle&keyword=seo&from=0&to=5
    Reply:
    {"responsecode":0,"result":[{"domainscore":"0","fromurl":"http:\/\/uniktapifakta.com\/p\/seo-tools.html","fromtitle":""},{"domainscore":" 0","fromurl":"http:\/\/incubaweb.com\/category\/web\/marketing-ingresos-seo\/","fromtitle":"Marketing\/Ingresos\/SEO Archives - Incubaweb - software y web 2.0"},{"domainscore":" 0","fromurl":"http:\/\/incubaweb.com\/black-friday-2015-aprovecha-el-seo-y-posicionate\/","fromtitle":"Black Friday 2015: Aprovecha el SEO y posici\u00f3nate"},{"domainscore":" 0","fromurl":"http:\/\/incubaweb.com\/30-consejos-sobre-seo-que-los-bloggers-deberian-tomar-en-cuenta\/","fromtitle":"30 consejos sobre SEO que los bloggers deber\u00edan tomar en cuenta - Incubaweb - software y web 2.0"},{"domainscore":" 0","fromurl":"http:\/\/incubaweb.com\/que-son-los-backlinks-y-como-ayudan-al-seo\/","fromtitle":"\u00bfQu\u00e9 son los backlinks y c\u00f3mo ayudan al SEO?"}]}

    Example: Getting the next 5 results for the keyword seo:

    http://apiurl/api.php?token=token&apitype=keywordlink&keyword=seo&from=5&to=10
    Reply:
    {"responsecode":0,"result":[{"domainscore":"0","fromurl":"http:\/\/incubaweb.com\/3-herramientas-imprescindibles-para-tener-controlado-tu-seo\/","fromtitle":"3 herramientas imprescindibles para tener controlado tu SEO - Incubaweb - software y web 2.0"},{"domainscore":" 0","fromurl":"http:\/\/incubaweb.com\/seo-todo-sobre-el-posicionamiento-en-buscadores-en-una-infografia\/","fromtitle":"SEO, todo sobre el posicionamiento en buscadores en una infograf\u00eda - Incubaweb - software y web 2.0"},{"domainscore":" 0","fromurl":"http:\/\/incubaweb.com\/category\/seo\/","fromtitle":"SEO Archives - Incubaweb - software y web 2.0"},{"domainscore":" 0","fromurl":"http:\/\/incubaweb.com\/tendencias-seo-para-el-2015\/","fromtitle":"Tendencias SEO para el 2015: las tres que se vienen"},{"domainscore":" 0","fromurl":"http:\/\/hostisc.com\/category\/seo\/","fromtitle":"SEO Archives - Hostisc.com"}]}

    The result data is:

  • fromdomainscore - From domain domain score.
  • fromurl - From URL that provides the backlink.
  • fromtitle - From URL's title.