MENU navbar-image

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

Coût d'utilisation de l'API

{
  'errors': false,
  'metas': {
    'search': 'www.ranks.fr',
    'path': 'host',
    'results': 2,
    'used-credits': 25,
    'remaining-credits': 119500
  },
   'data': [
  {...},
  {...}
  ]
}

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:

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

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/seo?search=www.ranks.fr&limit=100&forcepath=host" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'www.ranks.fr',
            'limit' => '100',
            'forcepath' => 'host',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo'
params = {
  'search': 'www.ranks.fr',
  'limit': '100',
  'forcepath': 'host',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
        }
    ]
}

Requête   

GET v1/seo

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: www.ranks.fr

limit   integer  optional  

Par défaut: 50 résultats Example: 100

forcepath   string  optional  

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

Réponse

Champs de la réponse

Date   string   

Date de la dernière mise à jour des résultats (seul le mois et l'année varient)

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nbkw   integer   

Nombre total de mots-clés identifiés dans les résultats de recherche (top 50 minimum)

kw10   integer   

Nombre de mots-clés positionnés dans les 10 premières positions

kw20   integer   

Nombre de mots-clés positionnés dans les 20 premières positions

kw3   integer   

Nombre de mots-clés positionnés dans les 3 premières positions

kw1   integer   

Nombre de mots-clés positionnés en première position

Nburl   integer   

Nombre d'urls positionnées

Rank   integer   

Classement du site

Mots-clés positionnés

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/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"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/keywords';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'www.ranks.fr',
            'limit' => '100',
            'forcepath' => 'host',
            'date' => '202506',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/keywords'
params = {
  'search': 'www.ranks.fr',
  'limit': '100',
  'forcepath': 'host',
  'date': '202506',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/seo/keywords

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: www.ranks.fr

limit   integer  optional  

Par défaut: 50 résultats Example: 100

forcepath   string  optional  

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

date   integer  optional  

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

count   integer  optional  

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

KwEq   string  optional  

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

RxGt   integer  optional  

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

RxEq   integer  optional  

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

RxLs   integer  optional  

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

VolGt   integer  optional  

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

VolEq   integer  optional  

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

VolLs   integer  optional  

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

CpcGt   string  optional  

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

CpcLs   string  optional  

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

NbGt   integer  optional  

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

NbLs   integer  optional  

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

IsAd   boolean  optional  

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

IsSh   boolean  optional  

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

IsAb   boolean  optional  

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

IsIm   boolean  optional  

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

IsBd   boolean  optional  

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

IsSp   boolean  optional  

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

IsNs   boolean  optional  

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

IsMp   boolean  optional  

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

IsKg   boolean  optional  

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

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Url   string   

Url exacte sur laquelle le site est positionné pour le mot-clé

Rx   integer   

Position dans les résultats de recherche naturelle (50 premiers résultats au minimum)

Vol   integer   

Volume de recherche mensuel pour ce mot-clé (estimation en provenance du générateur de mots-clés google adwords)

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nb   integer   

Nombre de résultats pour le mot-clé (donnée affichée dans une recherche google)

Cpc   string   

Cout par clic adwords maximum en euros

SeoKd   integer   

indice de concurrence SEO

SeaKd   integer   

indice de concurrence SEA

Date   string   

Date de la dernière mise à jour des résultats pour ce mot-clé

Urls positionnées

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/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"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/urls';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'www.ranks.fr',
            'limit' => '100',
            'forcepath' => 'host',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/urls'
params = {
  'search': 'www.ranks.fr',
  'limit': '100',
  'forcepath': 'host',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/seo/urls

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: www.ranks.fr

limit   integer  optional  

Par défaut: 50 résultats Example: 100

forcepath   string  optional  

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

Réponse

Champs de la réponse

Url   string   

Url exacte sur laquelle le site est positionné pour le mot-clé

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nbkw   integer   

Nombre de mots-clés positionnés pour cette url

GtPot   integer   

Gain de trafic potentiel pour cette url

Date   string   

Date de la dernière mise à jour des résultats pour ce mot-clé

Analyse de la concurrence

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

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/seo/competitors?search=www.ranks.fr&limit=100" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/competitors';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'www.ranks.fr',
            'limit' => '100',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/competitors'
params = {
  'search': 'www.ranks.fr',
  'limit': '100',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/seo/competitors

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (sous-domaine) Example: www.ranks.fr

limit   integer  optional  

Par défaut: 50 résultats Example: 100

Réponse

Champs de la réponse

Conc   string   

| Url du site concurrent

Ind   integer   

| Indicateur de l'intensité de concurrence

Est   integer   

| Estimation du trafic seo (nombre de visiteurs par mois)

Nbkw   integer   

| Nombre de mots-clés positionnés pour ce site

kw10   integer   

| Nombre de mots-clés positionnés dans les 10 premières positions

kw1   integer   

| Nombre de mots-clés positionnés en première position

Nburl   integer   

| Nombre d'urls positionnées

Date   string   

| Date de la dernière mise à jour des concurrents

Création audit de positionnement

Récupé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))

Exemple de requête:
curl --request POST \
    "api.ranxplorer.com/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\"
    ]
}"

$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/positions/batch';
$response = $client->post(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'search' => 'ranxplorer.com',
            'date' => 202511,
            'keywords' => [
                'outil seo',
                'logiciel seo',
                'api seo',
                'meteo grenoble',
                'mot pas en base',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/positions/batch'
payload = {
    "search": "ranxplorer.com",
    "date": 202511,
    "keywords": [
        "outil seo",
        "logiciel seo",
        "api seo",
        "meteo grenoble",
        "mot pas en base"
    ]
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Exemple de réponse (200):


{
    "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"
    }
}

Requête   

POST v1/seo/positions/batch

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

paramètres dans le body

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: ranxplorer.com

date   integer  optional  

(format AAAAMM) Par défaut: Mois courant Example: 202511

keywords   string[]  optional  

Tableau qui contient les expressions string[]

Réponse

Champs de la réponse

batch_id   string   

Identifiant de votre audit de positionnement

batch_status   string   

Statut de votre audit de positionnement

Récupération audit de positionnement

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

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/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"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/positions/batch';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'batchId' => '5108a7ec-372e-429f-8047-0e42a7057f42',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/positions/batch'
params = {
  'batchId': '5108a7ec-372e-429f-8047-0e42a7057f42',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
        }
    ]
}

Requête   

GET v1/seo/positions/batch

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

batchId   string   

Identifiant du batch à récupérer Example: 5108a7ec-372e-429f-8047-0e42a7057f42

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Status   string   

Indique si le mot clé est présent dans la base de Ranxplorer (checked ou not-checked)

Rx   integer   

Position dans les résultats de recherche naturelle (50 premiers résultats au minimum)

Host   string   

Host

Url   string   

Url exacte sur laquelle le site est positionné pour le mot-clé

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Vol   integer   

Volume de recherche mensuel pour ce mot-clé (estimation en provenance du générateur de mots-clés google adwords)

Date   string   

Date de la dernière mise à jour des résultats pour ce mot-clé

Optimisation de mots clés à court terme

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/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"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/opportunitiesct';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'www.madeindesign.com/mobilier.html',
            'limit' => '2',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/opportunitiesct'
params = {
  'search': 'www.madeindesign.com/mobilier.html',
  'limit': '2',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
        }
    ]
}

Requête   

GET v1/seo/opportunitiesct

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: www.madeindesign.com/mobilier.html

limit   integer  optional  

Par défaut: 50 résultats Example: 2

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Rx   integer   

Position dans les résultats de recherche naturelle (50 premiers résultats au minimum)

Vol   integer   

Volume de recherche mensuel pour ce mot-clé (estimation en provenance du générateur de mots-clés google adwords)

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nb      

Nombre de résultats pour le mot-clé (donnée affichée dans une recherche google)

RxPot   integer   

Position simulée dans les résultats de recherche naturelle (50 premiers résultats au minimum)

EstPot   integer   

Estimation du trafic seo potentiel(nombre de visiteurs par mois)

GtPot   integer   

Estimation du gain de trafic seo potentiel (nombre de visiteurs par mois)

Cpc      

Cout par clic adwords maximum en euros

SeaKd   integer   

indice de difficulté sea

SeoKd   integer   

indice de difficulté seo

Optimisation de mots clés à long terme

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/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"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/opportunitieslt';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'www.madeindesign.com/mobilier.html',
            'limit' => '2',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/opportunitieslt'
params = {
  'search': 'www.madeindesign.com/mobilier.html',
  'limit': '2',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
        }
    ]
}

Requête   

GET v1/seo/opportunitieslt

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: www.madeindesign.com/mobilier.html

limit   integer  optional  

Par défaut: 50 résultats Example: 2

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Rx   integer   

Position dans les résultats de recherche naturelle (50 premiers résultats au minimum)

Vol   integer   

Volume de recherche mensuel pour ce mot-clé (estimation en provenance du générateur de mots-clés google adwords)

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nb      

Nombre de résultats pour le mot-clé (donnée affichée dans une recherche google)

RxPot   integer   

Position simulée dans les résultats de recherche naturelle (50 premiers résultats au minimum)

EstPot   integer   

Estimation du trafic seo potentiel(nombre de visiteurs par mois)

GtPot   integer   

Estimation du gain de trafic seo potentiel (nombre de visiteurs par mois)

Cpc      

Cout par clic adwords maximum en euros

SeaKd   integer   

indice de difficulté sea

SeoKd   integer   

indice de difficulté seo

Sea

Historique SEA

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/sea?search=madeindesign.com&limit=2&forcepath=domaine" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/sea';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'madeindesign.com',
            'limit' => '2',
            'forcepath' => 'domaine',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/sea'
params = {
  'search': 'madeindesign.com',
  'limit': '2',
  'forcepath': 'domaine',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
        }
    ]
}

Requête   

GET v1/sea

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: madeindesign.com

limit   integer  optional  

Par défaut: 50 résultats Example: 2

forcepath   string  optional  

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

Réponse

Champs de la réponse

Date   string   

Date de la dernière mise à jour des résultats (seul le mois et l'année varient)

Cost   integer   

Budget adwords estimé en euros à partir du nombre de mots-clés, de leur positions adwords et du CPC max

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nbkw   integer   

Nombre total de mots-clés identifiés dans les résultats de recherche (top 50 minimum)

Nburl   integer   

Nombre d'urls positionnées

Mots-clés positionnés

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/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"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/sea/keywords';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'madeindesign.com',
            'limit' => '2',
            'forcepath' => 'domaine',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/sea/keywords'
params = {
  'search': 'madeindesign.com',
  'limit': '2',
  'forcepath': 'domaine',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/sea/keywords

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: madeindesign.com

limit   integer  optional  

Par défaut: 50 résultats Example: 2

forcepath   string  optional  

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

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Url   string   

Url exacte sur laquelle le site est positionné pour le mot-clé

Typ   string   

Type d'annonce (Adwords haut, Adwords bas ou Shopping)

Rx   integer   

Position dans les résultats de recherche naturelle (50 premiers résultats au minimum)

Vol   integer   

Volume de recherche mensuel pour ce mot-clé (estimation en provenance du générateur de mots-clés google adwords)

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nb   integer   

Nombre de résultats pour le mot-clé (donnée affichée dans une recherche google)

Cpc   string   

Cout par clic adwords maximum en euros

Date   string   

Date de la dernière mise à jour des résultats pour ce mot-clé

Urls positionnées

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/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"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/sea/urls';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'madeindesign.com',
            'limit' => '2',
            'forcepath' => 'domaine',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/sea/urls'
params = {
  'search': 'madeindesign.com',
  'limit': '2',
  'forcepath': 'domaine',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/sea/urls

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: madeindesign.com

limit   integer  optional  

Par défaut: 50 résultats Example: 2

forcepath   string  optional  

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

Réponse

Champs de la réponse

Url   string   

Url exacte sur laquelle le site est positionné pour le mot-clé

Est   integer   

Estimation du trafic seo (nombre de visiteurs par mois)

Nbkw   integer   

Nombre de mots-clés positionnés pour cette url

Date   string   

Date de la dernière mise à jour des résultats pour ce mot-clé

Serps

Analyse Serps

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é.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/seo/serps?search=ranxplorer&limit=50&date=202510" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/seo/serps';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'ranxplorer',
            'limit' => '50',
            'date' => '202510',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/seo/serps'
params = {
  'search': 'ranxplorer',
  'limit': '50',
  'date': '202510',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/seo/serps

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

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

limit   integer  optional  

Par défaut: 50 résultats Example: 50

date   integer  optional  

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

Réponse

Champs de la réponse

Url   string   

Url exacte sur laquelle le site est positionné pour le mot-clé

Rx   integer   

Position dans les résultats de recherche naturelle (50 premiers résultats au minimum)

Ssl   integer   

Indique si l'url est disponible via HTTP ou HTTPS

Date   string   

Date de la dernière mise à jour des résultats pour ce mot-clé

Serps Sea

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é.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/sea/serps?search=ranxplorer&limit=50" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/sea/serps';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'ranxplorer',
            'limit' => '50',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/sea/serps'
params = {
  'search': 'ranxplorer',
  'limit': '50',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/sea/serps

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (mot ou expression) Example: ranxplorer

limit   integer  optional  

Par défaut: 50 résultats Example: 50

Réponse

Champs de la réponse

Url   string   

Url exacte sur laquelle le site est positionné pour le mot-clé

Typ   string   

Type d'annonce (Adwords haut, Adwords bas ou Shopping)

Rx   integer   

Position dans les résultats de recherche payants

Ssl   integer   

Indique si l'url est disponible via HTTP ou HTTPS

Date   string   

Date de la dernière mise à jour des résultats pour ce mot-clé

Mots-clés

Détail mot-clé

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

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/kwd?search=ranxplorer" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/kwd';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'ranxplorer',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/kwd'
params = {
  'search': 'ranxplorer',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
    }
}

Requête   

GET v1/kwd

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Mot ou expression à rechercher Example: ranxplorer

Réponse

Champs de la réponse

Vol   integer   

volume de recherche mensuel pour le mot-clé (moyenne annuelle)

M1   integer   

volume de recherche mensuel pour ce mot-clé en Janvier

M2   integer   

volume de recherche mensuel pour ce mot-clé en Février

M3   integer   

volume de recherche mensuel pour ce mot-clé en Mars

M4   integer   

volume de recherche mensuel pour ce mot-clé en Avril

M5   integer   

volume de recherche mensuel pour ce mot-clé en Mai

M6   integer   

volume de recherche mensuel pour ce mot-clé en Juin

M7   integer   

volume de recherche mensuel pour ce mot-clé en Juillet

M8   integer   

volume de recherche mensuel pour ce mot-clé en Aout

M9   integer   

volume de recherche mensuel pour ce mot-clé en Septembre

M10   integer   

volume de recherche mensuel pour ce mot-clé en Octobre

M11   integer   

volume de recherche mensuel pour ce mot-clé en Novembre

M12   integer   

volume de recherche mensuel pour ce mot-clé en Décembre

Cpc   string   

Cout par clic adwords maximum en euros

Comp   integer   

indice de niveau de concurrence moyen pour le mot-clé, en adwords (indice compris entre 0 et 1)

Nb   integer   

Nombre de résultats pour le mot-clé (donnée affichée dans une recherche google)

IsAd   integer   

Déclenche l'affichage d'un snippet google adwords

IsSh   integer   

Déclenche l'affichage d'un snippet google shopping

IsIm   integer   

Déclenche l'affichage d'un snippet google images

IsBd   integer   

Considéré comme une marque

IsSp   integer   

Comporte une faute d'orthographe

IsNs   integer   

Déclenche l'affichage d'un snippet google Actualités

IsMp   integer   

Déclenche l'affichage d'un snippet google Map

IsKg   integer   

Déclenche l'affichage d'un snippet knowledge graph

IsAb   integer   

Déclenche l'affichage d'un snippet Answer box

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

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/kwd/similars?search=ranxplorer&limit=25" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/kwd/similars';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'ranxplorer',
            'limit' => '25',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/kwd/similars'
params = {
  'search': 'ranxplorer',
  'limit': '25',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/kwd/similars

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Mot ou expression à rechercher Example: ranxplorer

limit   integer  optional  

Par défaut: 25 Example: 25

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Vol   integer   

volume de recherche mensuel pour le mot-clé (moyenne annuelle)

Cpc   string   

Cout par clic adwords maximum en euros

Comp   string   

indice de niveau de concurrence moyen pour le mot-clé, en adwords (indice compris entre 0 et 1)

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

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.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/kwd/broadmatch?search=seo&limit=25" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/kwd/broadmatch';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'seo',
            'limit' => '25',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/kwd/broadmatch'
params = {
  'search': 'seo',
  'limit': '25',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
        }
    ]
}

Requête   

GET v1/kwd/broadmatch

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Mot ou expression à rechercher Example: seo

limit   integer  optional  

Par défaut: 25 Example: 25

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Vol   integer   

volume de recherche mensuel pour le mot-clé (moyenne annuelle)

Cpc   string   

Cout par clic adwords maximum en euros

Comp   integer   

indice de niveau de concurrence moyen pour le mot-clé, en adwords (indice compris entre 0 et 1)

Questions liées

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

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/kwd/ask?search=seo&limit=25" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/kwd/ask';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'seo',
            'limit' => '25',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/kwd/ask'
params = {
  'search': 'seo',
  'limit': '25',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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
        }
    ]
}

Requête   

GET v1/kwd/ask

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Mot ou expression à rechercher Example: seo

limit   integer  optional  

Par défaut: 25 Example: 25

Réponse

Champs de la réponse

Kw   string   

Mot-clé

Vol   integer   

volume de recherche mensuel pour le mot-clé (moyenne annuelle)

Cpc   string   

Cout par clic adwords maximum en euros

Comp   integer   

indice de niveau de concurrence moyen pour le mot-clé, en adwords (indice compris entre 0 et 1)

Backlinks

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é.

Exemple de requête:
curl --request GET \
    --get "api.ranxplorer.com/v1/bls?search=ranxplorer.com" \
    --header "X-Ranxplorer-Token: {Token_api}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'api.ranxplorer.com/v1/bls';
$response = $client->get(
    $url,
    [
        'headers' => [
            'X-Ranxplorer-Token' => '{Token_api}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'search' => 'ranxplorer.com',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'api.ranxplorer.com/v1/bls'
params = {
  'search': 'ranxplorer.com',
}
headers = {
  'X-Ranxplorer-Token': '{Token_api}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Exemple de réponse (200):


{
    "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"
        }
    ]
}

Requête   

GET v1/bls

Headers

X-Ranxplorer-Token      

Example: {Token_api}

Content-Type      

Example: application/json

Accept      

Example: application/json

Paramètres de requête

search   string   

Entité à rechercher (domaine, sous-domaine, répertoire ou url) Example: ranxplorer.com

Réponse

Champs de la réponse

tf   integer   

Trustflow

cf   integer   

CitationFlow

bls   integer   

Nombre de backlinks

rd   integer   

Nombre de domaines référents

rips   integer   

Nombre de refering IPs

ttf   string   

Topical

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
403 Invalid token Votre token d'identification n'est pas reconnu comme valable
403 Not enough credits Votre crédit API n'est pas suffisant pour effectuer cette requête
404  Record not found  L'adresse demandée n'existe pas