Ranxplorer API Documentation

Postman collection →

Introduction

Bienvenue sur l'API ranxplorer. Ce guide d'utilisation décrit les différentes méthodes accessibles via l'API. L'API a été conçue pour faciliter l'accès à notre base de plus de 3 milliards de résultats et 100 millions de mots-clés.

Fonctionnement de l'API

L'utilisation de l'API est réservé aux comptes Premium. Pour accéder à l'API, vous devez utiliser votre token API disponible dans votre interface client sur le site ranxplorer.com

Chaque requête adressée à l'API est facturée sur la base d'un montant de 1 crédit par ligne de résultats renvoyés. Néanmoins pour prendre en compte la charge consommée à chaque requête, le coût minimum par requête est de 25 crédits.

Par exemple, le côut pour la récupération des 100 premières positions d'un site sera de 100 crédits tandis que le coût pour la récupération de la première position sera de 25 crédits (seuil minimum). Pour que vous puissiez maitrisez au mieux votre budget, vous pouvez choisir la limite de résultats que vous souhaitez obtenir pour chaque requête. Par ailleurs, chaque réponse renvoyée par l'API contient un élément méta qui récapitule:

  • la recherche effectuée (search)
  • le contexte retenu pour la recherche (path)
  • le nombre de résultats renvoyés (results)
  • le nombre de crédits consommés pour cette requête (used-credits)
  • le nombre de crédits disponibles sur votre solde (remaining-credits)

Le rate-limit est fixé à 120 requêtes par minute

Authentification

Pour authentifier vos requêtes, Vous devez inclure inclure le paramètre X-Ranxplorer-Token dans le header de chaque requête avec la valeur de votre "{Token_api}".

Pour accéder à l'API, vous devez utiliser votre token API disponible dans votre interface client sur le site ranxplorer.com.

Seo

Historique SEO

GET
api.ranxplorer.test
/v1/seo
requires authentication

Récupérez une synthèse historisée des principaux indicateurs clés de la visibilité d'un site dans les résultats de recherche naturelle. La recherche peut porter sur un domaine, un sous-domaine, un répertoire ou une url. Si la recherche porte sur un répertoire ou une url, seul le dernier mois est disponible. A noter également que par défaut, les données sont triées par ordre chronologique croissant.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
www.ranks.fr
limit
integer

Par défaut: 50 résultats

Example:
100
forcepath
string

Pour forcer un contexte d'arborescence: domaine, host, dir ou url

Example:
host
sortby
string

Croissant par défaut, Desc_Date pour classer par ordre décroissant

Example:
Desc_Date

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo?search=www.ranks.fr&limit=100&forcepath=host&sortby=Desc_Date" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.ranks.fr",
        "path": "host",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119500
    },
    "data": [
        {
            "Date": "2015-11",
            "Est": 4884,
            "Nbkw": 2726,
            "kw20": 256,
            "kw10": 113,
            "kw3": 13,
            "kw1": 7,
            "Nburl": 701,
            "Rank": 958000
        },
        {
            "Date": "2015-12",
            "Est": 4964,
            "Nbkw": 2845,
            "kw20": 243,
            "kw10": 124,
            "kw3": 21,
            "kw1": 7,
            "Nburl": 707,
            "Rank": 975000
        }
    ]
}

Mots-clés positionnés

GET
api.ranxplorer.test
/v1/seo/keywords
requires authentication

Récupérez la liste des expressions sur lesquelles un site apparait dans les 50 premiers résultats naturels au minimum (jusqu'à 100 en fonction du mot-clé). La recherche peut porter sur un domaine, un sous-domaine, un répertoire ou une url.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
www.ranks.fr
limit
integer

Par défaut: 50 résultats

Example:
100
forcepath
string

Pour forcer un contexte d'arborescence: domaine, host, dir ou url

Example:
host
date
integer

optionnel Spécifie le mois à interroger au format AAAAMM (12 derniers mois au max)

Example:
202506
count
integer

optionnel Renvoie uniquement le nombre de résultats si count=1

KwEq
string

optionnel Filter les résultats sur une expression ou un mot clé via opérateurs booléens

RxGt
integer

optional Filter sur les positions du sites supérieures à un rang (>) entre 0 et 99

RxEq
integer

optional Filter sur les positions du sites égales à un rang (=) entre 1 et 100

RxLs
integer

optional Filter sur les positions du sites inférieures à un rang (<) entre 2 et 100

VolGt
integer

optional Filter sur les mots clés dont le volume de recherche est supérieur à une valeur

VolEq
integer

optional Filter sur les mots clés dont le volume de recherche est égal à une valeur

VolLs
integer

optional Filter sur les mots clés dont le volume de recherche est inférieur à une valeur

CpcGt
string

numeric optional Filter sur les mots clés dont le coût par clic est supérieur à une valeur

CpcLs
string

numeric optional Filter sur les mots clés dont le coût par clic est inférieur à une valeur

NbGt
integer

optional Filter sur les mots clés dont le nombre de résultats est supérieur à une valeur

NbLs
integer

optional Filter sur les mots clés dont le nombre de résultats est inférieur à une valeur

IsAd
boolean

optional Filtrer sur les mots clés avec des Adwords (valeur 1 ou 0)

IsSh
boolean

optional Filtrer sur les mots clés avec des annonces Shopping/PLA (valeur 1 ou 0)

IsAb
boolean

optional Filtrer sur les mots clés avec des AnswerBox (valeur 1 ou 0)

IsIm
boolean

optional Filtrer sur les mots clés avec des images (valeur 1 ou 0)

IsBd
boolean

optional Filtrer sur les mots clés liés à des marques (valeur 1 ou 0)

IsSp
boolean

optional Filtrer sur les mots clés avec des fautes d'orthographes(valeur 1 ou 0)

IsNs
boolean

optional Filtrer sur les mots clés avec des actualités (valeur 1 ou 0)

IsMp
boolean

optional Filtrer sur les mots clés avec des maps(valeur 1 ou 0)

IsKg
boolean

optional Filtrer sur les mots clés avec des knowledges graphs(valeur 1 ou 0)

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo/keywords?search=www.ranks.fr&limit=100&forcepath=host&date=202506" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.ranks.fr",
        "path": "host",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119825
    },
    "data": [
        {
            "Kw": "ranks",
            "Url": "www.ranks.fr/",
            "Rx": 1,
            "Vol": 1890,
            "Est": 1701,
            "Nb": 0,
            "Cpc": "0.00",
            "SeaKd": 0,
            "SeoKd": 70,
            "Date": "2025-05-28"
        },
        {
            "Kw": "rank",
            "Url": "www.ranks.fr/",
            "Rx": 4,
            "Vol": 2900,
            "Est": 290,
            "Nb": 0,
            "Cpc": "0.00",
            "SeaKd": 0,
            "SeoKd": 62,
            "Date": "2025-06-02"
        }
    ]
}

Urls positionnées

GET
api.ranxplorer.test
/v1/seo/urls
requires authentication

Récupérez la liste des urls sur lesquelles un site apparait dans les 50 premiers résultats naturels au minimum. La recherche peut porter sur un domaine, un sous-domaine, un répertoire ou une url.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
www.ranks.fr
limit
integer

Par défaut: 50 résultats

Example:
100
forcepath
string

Pour forcer un contexte d'arborescence: domaine, host, dir ou url

Example:
host

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo/urls?search=www.ranks.fr&limit=100&forcepath=host" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.ranks.fr",
        "path": "host",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119800
    },
    "data": [
        {
            "Url": "www.ranks.fr/",
            "Est": 2120,
            "Nbkw": 29,
            "GtPot": 641,
            "Date": "2025-06"
        },
        {
            "Url": "www.ranks.fr/fr/?force_interface=normal",
            "Est": 51,
            "Nbkw": 38,
            "GtPot": 51,
            "Date": "2025-06"
        }
    ]
}

Analyse de la concurrence

GET
api.ranxplorer.test
/v1/seo/competitors
requires authentication

Récupérez la liste des concurrents pour un sous-domaine(host) donné.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (sous-domaine)

Example:
www.ranks.fr
limit
integer

Par défaut: 50 résultats

Example:
100

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo/competitors?search=www.ranks.fr&limit=100" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.madeindesign.com",
        "path": "host",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119775
    },
    "data": [
        {
            "Conc": "www.woorank.com",
            "Est": 2664,
            "Nbkw": 869,
            "kw10": 132,
            "kw1": 10,
            "Nburl": 119,
            "Ind": 0,
            "Nbsamekw": 0,
            "pourcent": 0,
            "Date": "2025-06"
        },
        {
            "Conc": "www.calcul-pagerank.fr",
            "Est": 788,
            "Nbkw": 126,
            "kw10": 99,
            "kw1": 18,
            "Nburl": 9,
            "Ind": 0,
            "Nbsamekw": 0,
            "pourcent": 0,
            "Date": "2025-06"
        }
    ]
}

Création audit de positionnement

POST
api.ranxplorer.test
/v1/seo/positions/batch
requires authentication

Générez un audit de positionnement pour une liste de mots clés, un site et un mois donné. A noter, le résultat de l'audit n'est pas immédiat. Votre demande est traitée en tache de fond. Vous pouvez suivre la progression et récupérer votre audit à partir de l'identifiant batchId qui vous est retourné (cf endpoint ci-dessous: récupération audit de positionnement))

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

paramètres dans le body

Champs de la réponse

Exemple de requête: 
curl --request POST \
    "api.ranxplorer.test/v1/seo/positions/batch" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"search\": \"ranxplorer.com\",
    \"date\": 202511,
    \"keywords\": [
        \"outil seo\",
        \"logiciel seo\",
        \"api seo\",
        \"meteo grenoble\",
        \"mot pas en base\"
    ]
}"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "ranxplorer.com",
        "path": "domaine",
        "results": 0,
        "used-credits": 0,
        "remaining-credits": 997963
    },
    "data": {
        "batch_id": "0a25474c-bc93-4f72-a472-cc07fbe71c16",
        "batch_status": "queued"
    }
}

Récupération audit de positionnement

GET
api.ranxplorer.test
/v1/seo/positions/batch
requires authentication

Récupérez un audit de positionnement créé préalablement à l'aide de votre batchId

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

batchId
string
required

Identifiant du batch à récupérer

Example:
5108a7ec-372e-429f-8047-0e42a7057f42

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo/positions/batch?batchId=5108a7ec-372e-429f-8047-0e42a7057f42" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "batch_id": "0a25474c-bc93-4f72-a472-cc07fbe71c16",
        "batch_status": "done",
        "results": 5,
        "used-credits": 25,
        "remaining-credits": 997963
    },
    "data": [
        {
            "Kw": "outil seo",
            "Status": "checked",
            "Rx": 7,
            "Host": "ranxplorer.com",
            "Url": "/",
            "Est": 21,
            "Vol": 690,
            "Date": "24-10-2025"
        },
        {
            "Kw": "meteo grenoble",
            "Status": "checked",
            "Rx": null,
            "Host": null,
            "Url": null,
            "Est": 0,
            "Vol": 488070,
            "Date": "06-11-2025"
        },
        {
            "Kw": "logiciel seo",
            "Status": "checked",
            "Rx": null,
            "Host": null,
            "Url": null,
            "Est": 0,
            "Vol": 270,
            "Date": "25-10-2025"
        },
        {
            "Kw": "mot pas en base",
            "Status": "not_checked",
            "Rx": null,
            "Host": null,
            "Url": null,
            "Est": null,
            "Vol": null,
            "Date": null
        }
    ]
}

Optimisation de mots clés à court terme

GET
api.ranxplorer.test
/v1/seo/opportunitiesct
requires authentication

Récupérez la liste des mots-clés à plus fort potentiel de gain de trafic à court terme. Le gain à court terme correspond à un gain simulé de 5 positions.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
www.madeindesign.com/mobilier.html
limit
integer

Par défaut: 50 résultats

Example:
2

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo/opportunitiesct?search=www.madeindesign.com%2Fmobilier.html&limit=2" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.madeindesign.com/mobilier.html",
        "path": "url",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119775
    },
    "data": [
        {
            "Kw": "mobilier",
            "Rx": 4,
            "Vol": 5400,
            "Est": 540,
            "RxPot": 1,
            "EstPot": 1620,
            "GtPot": 1080,
            "cpc": "0.60",
            "SeaKd": 75,
            "SeoKd": 69
        },
        {
            "Kw": "meuble design pas cher",
            "Rx": 7,
            "Vol": 2900,
            "Est": 87,
            "RxPot": 2,
            "EstPot": 522,
            "GtPot": 435,
            "cpc": "0.64",
            "SeaKd": 100,
            "SeoKd": 80
        }
    ]
}

Optimisation de mots clés à long terme

GET
api.ranxplorer.test
/v1/seo/opportunitieslt
requires authentication

Récupérez la liste des mots-clés à plus fort potentiel de gain de trafic à long terme. Le gain à long terme correspond à un gain simulé de 20 positions.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
www.madeindesign.com/mobilier.html
limit
integer

Par défaut: 50 résultats

Example:
2

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo/opportunitieslt?search=www.madeindesign.com%2Fmobilier.html&limit=2" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.madeindesign.com/luminaire.html",
        "path": "url",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119775
    },
    "data": [
        {
            "Kw": "lustre design",
            "Rx": 4,
            "Vol": 6600,
            "Est": 660,
            "RxPot": 1,
            "EstPot": 1980,
            "GtPot": 1320,
            "cpc": "0.75",
            "SeaKd": 100,
            "SeoKd": 54
        },
        {
            "Kw": "france luminaire",
            "Rx": 12,
            "Vol": 2400,
            "Est": 20,
            "RxPot": 1,
            "EstPot": 720,
            "GtPot": 700,
            "cpc": "0.19",
            "SeaKd": 40,
            "SeoKd": 100
        }
    ]
}

Sea

Historique SEA

GET
api.ranxplorer.test
/v1/sea
requires authentication

Récupérez une synthèse historisée des principaux indicateurs clés de la visibilité d'un site dans les résultats de recherche payants. La recherche peut porter sur un domaine, un sous-domaine, un répertoire ou une url. Si la recherche porte sur un répertoire ou une url, seul le dernier mois est disponible.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
madeindesign.com
limit
integer

Par défaut: 50 résultats

Example:
2
forcepath
string

Pour forcer un contexte d'arborescence: domaine, host, dir ou url

Example:
domaine

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/sea?search=madeindesign.com&limit=2&forcepath=domaine" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "madeindesign.com",
        "path": "domaine",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 115950
    },
    "data": [
        {
            "Date": "2016-08",
            "Est": 17393,
            "Cost": 5450,
            "Nbkw": 5602,
            "Nburl": 1121
        },
        {
            "Date": "2016-09",
            "Est": 21845,
            "Cost": 6497,
            "Nbkw": 9268,
            "Nburl": 1311
        }
    ]
}

Mots-clés positionnés

GET
api.ranxplorer.test
/v1/sea/keywords
requires authentication

Récupérez la liste des expressions sur lesquelles un site apparait dans les résultats sponsorisés (Ads, Shopping). La recherche peut porter sur un domaine, un sous-domaine, un répertoire ou une url.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
madeindesign.com
limit
integer

Par défaut: 50 résultats

Example:
2
forcepath
string

Pour forcer un contexte d'arborescence: domaine, host, dir ou url

Example:
domaine

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/sea/keywords?search=madeindesign.com&limit=2&forcepath=domaine" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.madeindesign.com",
        "path": "host",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119350
    },
    "data": [
        {
            "Kw": "made in design",
            "Url": "www.madeindesign.com/",
            "Typ": "Adwords haut",
            "Rx": 1,
            "Vol": 60500,
            "Est": 4302,
            "Nb": 316000000,
            "Cpc": "0.13",
            "Date": "2016-09-01"
        },
        {
            "Kw": "fermob",
            "Url": "www.madeindesign.com/b-fermob.html",
            "Typ": "Adwords haut",
            "Rx": 1,
            "Vol": 33100,
            "Est": 2354,
            "Nb": 1740000,
            "Cpc": "0.44",
            "Date": "2016-09-01"
        }
    ]
}

Urls positionnées

GET
api.ranxplorer.test
/v1/sea/urls
requires authentication

Récupérez la liste des urls sur lesquelles un site apparait dans les résultats payants. La recherche peut porter sur un domaine, un sous-domaine, un répertoire ou une url.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
madeindesign.com
limit
integer

Par défaut: 50 résultats

Example:
2
forcepath
string

Pour forcer un contexte d'arborescence: domaine, host, dir ou url

Example:
domaine

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/sea/urls?search=madeindesign.com&limit=2&forcepath=domaine" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "www.madeindesign.com",
        "path": "host",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119325
    },
    "data": [
        {
            "Url": "www.madeindesign.com/",
            "Est": 12228,
            "Nbkw": 5960,
            "Date": "2016-09-01"
        },
        {
            "Url": "www.madeindesign.com/b-fermob.html",
            "Est": 2471,
            "Nbkw": 19,
            "Date": "2016-09-01"
        }
    ]
}

Serps

Analyse Serps

GET
api.ranxplorer.test
/v1/seo/serps
requires authentication

Récupérez la liste des résultats affichés dans les résultats naturels pour un mot-clé donné. Pour un mot-clé présent dans notre base de données, nous collectons au minimum les 50 premiers résultats, jusqu'à 100 en fonction du mot clé. A noter, cette requête est facturée 25 crédits quelque soit le nombre de lignes qui est retourné.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
ranxplorer
limit
integer

Par défaut: 50 résultats

Example:
50
date
integer

Spécifie le mois à interroger au format AAAAMM (12 derniers mois au max)

Example:
202510

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/seo/serps?search=ranxplorer&limit=50&date=202510" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "design",
        "path": "serps",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119775
    },
    "data": [
        {
            "Url": "fr.wikipedia.org/wiki/Design",
            "Rx": 1,
            "Ssl": 1,
            "Date": "2016-09-03"
        },
        {
            "Url": "www.madeindesign.com/",
            "Rx": 2,
            "Ssl": 0,
            "Date": "2016-09-03"
        }
    ]
}

Serps Sea

GET
api.ranxplorer.test
/v1/sea/serps
requires authentication

Récupérez la liste des résultats affichés dans les résultats naturels pour un mot-clé donné. Pour un mot-clé présent dans notre base de données, nous collectons au minimum les 50 premiers résultats, jusqu'à 100 en fonction du mot clé. A noter, cette requête est facturée 25 crédits quelque soit le nombre de lignes qui est retourné.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (mot ou expression)

Example:
ranxplorer
limit
integer

Par défaut: 50 résultats

Example:
50

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/sea/serps?search=ranxplorer&limit=50" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "credit",
        "path": "serps",
        "results": 2,
        "used-credits": 25,
        "remaining-credits": 119300
    },
    "data": [
        {
            "Url": "www.carrefour-banque.fr/credit/pret-personnel/simulation-pret",
            "Typ": "Adwords haut",
            "Rx": 1,
            "Ssl": 0,
            "Date": "2016-09-10"
        },
        {
            "Url": "www.cofidis.fr/fr/credit_en_ligne/simulateur-credits.html",
            "Typ": "Adwords haut",
            "Rx": 2,
            "Ssl": 1,
            "Date": "2016-09-10"
        }
    ]
}

Mots-clés

Détail mot-clé

GET
api.ranxplorer.test
/v1/kwd
requires authentication

Récupérez les informations liées à un mot-clé tels que le volume de recherche ou la typologie du mot-clé.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Mot ou expression à rechercher

Example:
ranxplorer

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/kwd?search=ranxplorer" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "ranxplorer",
        "path": "keyword",
        "results": 1,
        "used-credits": 25,
        "remaining-credits": 998896
    },
    "data": {
        "Vol": 1900,
        "M1": 2289,
        "M2": 1812,
        "M3": 1812,
        "M4": 2289,
        "M5": 1812,
        "M6": 1812,
        "M7": 1526,
        "M8": 1240,
        "M9": 2289,
        "M10": 1812,
        "M11": 2289,
        "M12": 1812,
        "Cpc": "0.10",
        "Comp": 12,
        "Nb": 0,
        "IsAd": 0,
        "IsSh": 0,
        "IsIm": 0,
        "IsBd": 1,
        "IsSp": 0,
        "IsNs": 0,
        "IsMp": 1,
        "IsKg": 0,
        "IsAb": 0
    }
}

Mots-clés liés (version stricte)

GET
api.ranxplorer.test
/v1/kwd/similars
requires authentication

Récupérez une liste de mots-clés liés à un mot-clé initial. Version stricte: les expressions renvoyées contiennent tous les mots présents dans l'expression recherchée.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Mot ou expression à rechercher

Example:
ranxplorer
limit
integer

Par défaut: 25

Example:
25

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/kwd/similars?search=ranxplorer&limit=25" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "ranxplorer",
        "path": "keyword",
        "results": 20,
        "used-credits": 25,
        "remaining-credits": 998871
    },
    "data": [
        {
            "Kw": "ranxplorer",
            "Vol": 1900,
            "Cpc": "0.11",
            "Comp": "0.11"
        },
        {
            "Kw": "ranxplorer gratuit",
            "Vol": 50,
            "Cpc": "0.38",
            "Comp": "0.55"
        },
        {
            "Kw": "avis ranxplorer",
            "Vol": 10,
            "Cpc": "0.00",
            "Comp": "0.29"
        },
        {
            "Kw": "ranxplorer avis",
            "Vol": 10,
            "Cpc": "0.00",
            "Comp": "0.14"
        },
        {
            "Kw": "ranxplorer logo",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer api",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer pricing",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "prix ranxplorer",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer *",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer prix",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "tarifs ranxplorer",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer vs semrush",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "utiliser ranxplorer",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "abonnement ranxplorer",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer tarif",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "tarif ranxplorer",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer seo",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer affiliation",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "api ranxplorer",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        },
        {
            "Kw": "ranxplorer tarifs",
            "Vol": 0,
            "Cpc": "0.00",
            "Comp": "0.00"
        }
    ]
}

Mots-clés liés (version large, cocon sémantique)

GET
api.ranxplorer.test
/v1/kwd/broadmatch
requires authentication

Récupérez une liste de mots-clés liés à un mot-clé initial. Version large: les expressions renvoyées sont liés au champ sématique recherché mais ne contiennent pas forcément les mots de l'expression recherchée.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Mot ou expression à rechercher

Example:
seo
limit
integer

Par défaut: 25

Example:
25

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/kwd/broadmatch?search=seo&limit=25" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "seo",
        "path": "serps",
        "results": 25,
        "used-credits": 25,
        "remaining-credits": 998841
    },
    "data": [
        {
            "Kw": "seo def",
            "Vol": 3270,
            "Cpc": "0.28",
            "Comp": 10
        },
        {
            "Kw": "seo définition",
            "Vol": 3050,
            "Cpc": "0.28",
            "Comp": 10
        },
        {
            "Kw": "referencement seo",
            "Vol": 2200,
            "Cpc": "2.00",
            "Comp": 39
        },
        {
            "Kw": "référencement seo",
            "Vol": 1810,
            "Cpc": "2.00",
            "Comp": 39
        },
        {
            "Kw": "search engine optimization",
            "Vol": 960,
            "Cpc": "1.15",
            "Comp": 10
        },
        {
            "Kw": "analyse seo",
            "Vol": 820,
            "Cpc": "1.96",
            "Comp": 50
        },
        {
            "Kw": "seo marketing",
            "Vol": 780,
            "Cpc": "0.88",
            "Comp": 12
        },
        {
            "Kw": "optimisation seo",
            "Vol": 670,
            "Cpc": "1.51",
            "Comp": 22
        },
        {
            "Kw": "seo definition",
            "Vol": 670,
            "Cpc": "0.29",
            "Comp": 6
        },
        {
            "Kw": "seo meaning",
            "Vol": 640,
            "Cpc": "0.52",
            "Comp": 4
        },
        {
            "Kw": "sea seo",
            "Vol": 590,
            "Cpc": "0.50",
            "Comp": 11
        },
        {
            "Kw": "seo referencement",
            "Vol": 530,
            "Cpc": "1.79",
            "Comp": 37
        },
        {
            "Kw": "qu'est ce que le seo",
            "Vol": 530,
            "Cpc": "0.22",
            "Comp": 35
        },
        {
            "Kw": "seo sem",
            "Vol": 480,
            "Cpc": "0.46",
            "Comp": 7
        },
        {
            "Kw": "défi définition",
            "Vol": 480,
            "Cpc": "0.00",
            "Comp": 0
        },
        {
            "Kw": "seo c'est quoi",
            "Vol": 460,
            "Cpc": "0.21",
            "Comp": 20
        },
        {
            "Kw": "être définition",
            "Vol": 320,
            "Cpc": "0.00",
            "Comp": 0
        },
        {
            "Kw": "définition seo",
            "Vol": 280,
            "Cpc": "0.28",
            "Comp": 6
        },
        {
            "Kw": "référencement naturel définition",
            "Vol": 280,
            "Cpc": "0.47",
            "Comp": 12
        },
        {
            "Kw": "stratégie seo",
            "Vol": 280,
            "Cpc": "0.49",
            "Comp": 18
        },
        {
            "Kw": "référencement naturel seo",
            "Vol": 220,
            "Cpc": "1.94",
            "Comp": 20
        },
        {
            "Kw": "definition seo",
            "Vol": 220,
            "Cpc": "0.28",
            "Comp": 6
        },
        {
            "Kw": "positionnement moteur de recherche",
            "Vol": 110,
            "Cpc": "0.00",
            "Comp": 3
        },
        {
            "Kw": "seo référencement",
            "Vol": 90,
            "Cpc": "4.68",
            "Comp": 60
        },
        {
            "Kw": "definition definition",
            "Vol": 90,
            "Cpc": "0.00",
            "Comp": 0
        }
    ]
}

Questions liées

GET
api.ranxplorer.test
/v1/kwd/ask
requires authentication

Récupérez une liste de questions liées à un mot-clé initial.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Mot ou expression à rechercher

Example:
seo
limit
integer

Par défaut: 25

Example:
25

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/kwd/ask?search=seo&limit=25" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "seo",
        "path": "keyword",
        "results": 14,
        "used-credits": 25,
        "remaining-credits": 998811
    },
    "data": [
        {
            "Kw": "qu'est ce que le seo",
            "Vol": 530,
            "Cpc": "0.22",
            "Comp": 35,
            "Kd": 19
        },
        {
            "Kw": "seo c'est quoi",
            "Vol": 460,
            "Cpc": "0.21",
            "Comp": 20,
            "Kd": 12
        },
        {
            "Kw": "qu est ce que le seo",
            "Vol": 340,
            "Cpc": "0.22",
            "Comp": 35,
            "Kd": 20
        },
        {
            "Kw": "que veut dire seo",
            "Vol": 40,
            "Cpc": "0.00",
            "Comp": 4,
            "Kd": 18
        },
        {
            "Kw": "c'est quoi seo",
            "Vol": 20,
            "Cpc": "3.48",
            "Comp": 7,
            "Kd": 13
        },
        {
            "Kw": "que signifie seo",
            "Vol": 20,
            "Cpc": "0.00",
            "Comp": 4,
            "Kd": 17
        },
        {
            "Kw": "qu'est ce que seo",
            "Vol": 20,
            "Cpc": "1.76",
            "Comp": 15,
            "Kd": 16
        },
        {
            "Kw": "seo score c'est quoi",
            "Vol": 20,
            "Cpc": "2.63",
            "Comp": 9,
            "Kd": 22
        },
        {
            "Kw": "seo qu'est ce que c'est",
            "Vol": 10,
            "Cpc": "0.00",
            "Comp": 1,
            "Kd": 13
        },
        {
            "Kw": "qu'est ce que le référencement seo",
            "Vol": 10,
            "Cpc": "0.00",
            "Comp": 36,
            "Kd": 17
        },
        {
            "Kw": "comment faire un audit seo",
            "Vol": 10,
            "Cpc": "2.26",
            "Comp": 30,
            "Kd": 13
        },
        {
            "Kw": "c'est quoi le seo",
            "Vol": 10,
            "Cpc": "0.00",
            "Comp": 16,
            "Kd": 12
        },
        {
            "Kw": "le seo c'est quoi",
            "Vol": 10,
            "Cpc": "5.70",
            "Comp": 6,
            "Kd": 10
        },
        {
            "Kw": "comment faire du seo",
            "Vol": 10,
            "Cpc": "0.00",
            "Comp": 12,
            "Kd": 19
        }
    ]
}

Backlinks

Synthèse backlinks

GET
api.ranxplorer.test
/v1/bls
requires authentication

Récupérez les principaux indicateurs de qualité des backlinks pour un domaine donné.

Headers

X-Ranxplorer-Token
Example:
{Token_api}
Content-Type
Example:
application/json
Accept
Example:
application/json

Paramètres de requête

search
string
required

Entité à rechercher (domaine, sous-domaine, répertoire ou url)

Example:
ranxplorer.com

Champs de la réponse

Exemple de requête: 
curl --request GET \
    --get "api.ranxplorer.test/v1/bls?search=ranxplorer.com" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Exemple de réponse:
{
    "errors": false,
    "metas": {
        "search": "ranxplorer.com",
        "path": "metricsbls",
        "results": 1,
        "used-credits": 25,
        "remaining-credits": 998786
    },
    "data": [
        {
            "tf": 62,
            "cf": 65,
            "bls": 956558,
            "rd": 4467,
            "rips": 1001,
            "ttf": "Recreation/Travel"
        }
    ]
}

Erreurs

Liste des erreurs et des messages liés

Exemple d'erreur

{
  "errors": true,
  "message": "Invalid token"
}
Code réponse HTTP Message Détail
400 Bad request Un problème est survenu dans le traitement de la requête (paramètres invalides ou manquants)
401 Invalid token Votre token d'identification n'est pas reconnu comme valable
403 Not enough credits Votre crédit API est insuffisant pour effectuer cette requête
404 Record not found Aucun résultat correspondant à votre requête n'a été trouvé
429 Too many requests Vous avez dépassé la limite de requêtes autorisée pour l'API
500 Server error Une erreur interne est survenue lors du traitement de la requête