API Rapid URL Indexer v1
API REST à 5 endpoints pour automatiser l'indexation : authentification par header X-API-Key, 9 999 URLs par projet, 100 requêtes par minute, Apex Mode activable par appel.
- URL de base
- https://rapidurlindexer.com/wp-json
- Authentification
- X-API-Key
- URLs par requête
- 9 999
- Débit
- 100 requêtes par minute et par clé
Cette page contient des liens affiliés : un achat via ces liens peut nous rémunérer, sans surcoût pour vous. Cela ne change ni notre notation ni nos conclusions. Notre modèle économique.
L'API de Rapid URL Indexer tient en cinq endpoints, là où celle de SpeedyIndex en compte neuf. Ce n'est pas un défaut : le service fait une seule chose, l'indexation Google, et l'API se limite à ce qu'il faut pour la piloter. En pratique, on l'intègre en une après-midi.
La particularité tient à son hébergement. L'API est servie par WordPress lui-même, d'où le préfixe /wp-json dans toutes les routes. Cela n'a aucune conséquence sur l'usage, mais explique la forme inhabituelle des URLs et le fait que l'authentification passe par un header X-API-Key plutôt que par le header Authorization standard.
Le paramètre qui mérite le plus d'attention est apex_mode_enabled. Il triple le coût de l'URL en échange d'un crawl annoncé en cinq minutes, et il modifie la garantie : en Apex Mode, seul 1 crédit sur les 3 est recrédité en cas d'échec, contre la totalité en mode standard. C'est un arbitrage à faire URL par URL, pas un réglage à activer globalement sans réfléchir.
// authentification
S'authentifier sur l'API Rapid URL Indexer
Toutes les requêtes exigent la clé API dans un header. Page My Projects du compte Rapid URL Indexer.
X-API-Key: VOTRE_CLE_API // endpoints
Les 5 endpoints de l'API
| Méthode | Chemin | Rôle |
|---|---|---|
| GET | /api/v1/credits/balance | Consulter le solde de crédits du compte. |
| GET | /api/v1/projects/list | Lister tous les projets du compte authentifié. |
| POST | /api/v1/projects 1 crédit par URL, ou 3 crédits en Apex Mode | Créer un projet et soumettre les URLs à indexer. Renvoie un project_id et un code HTTP 201. |
| GET | /api/v1/projects/{project_id} | Récupérer le statut et l'avancement d'un projet précis. |
| GET | /api/v1/projects/{project_id}/report | Télécharger le rapport d'indexation du projet, URL par URL. |
// paramètres
Paramètres de la requête de création
| Paramètre | Type | Description |
|---|---|---|
project_name requis | string | De 1 à 255 caractères. La valeur est assainie côté serveur. |
urls requis | array | De 1 à 9 999 URLs. Chacune doit commencer par http:// ou https://, sans quoi la requête est rejetée en 400. |
notify_on_status_change | boolean | Envoie un email à chaque changement de statut du projet. Faux par défaut. |
apex_mode_enabled | boolean | Passe le projet en Apex Mode : crawl visé en 5 minutes et jusqu'à 3 tentatives, pour 3 crédits par URL au lieu d'un. Faux par défaut. |
// exemple
Créer une tâche d'indexation
curl -X POST https://rapidurlindexer.com/wp-json/api/v1/projects \
-H 'X-API-Key: VOTRE_CLE_API' \
-H 'Content-Type: application/json' \
-d '{
"project_name": "backlinks juillet",
"urls": ["https://exemple.fr/page-1", "https://exemple.fr/page-2"],
"notify_on_status_change": true,
"apex_mode_enabled": false
}' {
"project_id": 48213,
"status": "pending",
"credits_used": 2
} // intégration
Automatiser les soumissions
const CLE = process.env.RUI_API_KEY;
const BASE = 'https://rapidurlindexer.com/wp-json/api/v1';
const entetes = { 'X-API-Key': CLE, 'Content-Type': 'application/json' };
async function solde() {
const r = await fetch(`${BASE}/credits/balance`, { headers: entetes });
if (r.status === 401) throw new Error('Clé API invalide ou absente');
return (await r.json()).balance;
}
async function creerProjet(nom, urls, apex = false) {
// L'Apex Mode consomme 3 crédits par URL au lieu d'un seul.
const cout = urls.length * (apex ? 3 : 1);
if ((await solde()) < cout) throw new Error(`Solde insuffisant : ${cout} crédits requis`);
const r = await fetch(`${BASE}/projects`, {
method: 'POST',
headers: entetes,
body: JSON.stringify({
project_name: nom.slice(0, 255),
urls,
notify_on_status_change: true,
apex_mode_enabled: apex,
}),
});
if (r.status === 429) throw new Error('Limite de 100 requêtes par minute atteinte');
if (r.status === 403) throw new Error('Crédits insuffisants ou permission refusée');
return (await r.json()).project_id;
} // pièges
Ce que la documentation officielle ne dit pas clairement
Les erreurs les plus fréquentes en intégrant l'API Rapid URL Indexer, relevées dans la documentation officielle et sur les retours d'intégration.
Le header est X-API-Key, pas Authorization
C'est la première cause de 401 sur cette API. L'habitude du header Authorization, standard partout ailleurs, ne fonctionne pas ici : la clé doit être passée dans X-API-Key.
La limite est de 9 999 URLs, pas 10 000
Le compte rond de 10 000 fait échouer la requête en 400. Découper par lots de 9 999 maximum, ou plus petit encore pour garder des projets lisibles dans le dashboard.
L'Apex Mode dégrade la garantie
En mode standard, une URL non indexée à J+14 est recréditée en totalité. En Apex Mode, elle coûte 3 crédits et 1 seul est recrédité : un échec vous laisse donc 2 crédits de perte sèche, là où le mode standard n'en laisse aucune.
Le rapport n'est complet qu'à J+14
Un premier rapport apparaît à J+4, mais il est partiel. Les recrédits automatiques et les chiffres définitifs n'arrivent qu'à J+14. Interroger l'endpoint report avant cette échéance donne un taux d'indexation artificiellement bas.
/wp-json n'est pas une faute de frappe
L'API est servie par WordPress, d'où ce préfixe dans toutes les routes. Il fait partie du chemin et ne doit pas être retiré.
// erreurs
Codes de retour et résolution
| Code | Signification | Résolution |
|---|---|---|
200 | Succès, les données demandées sont renvoyées. | Aucune action. |
201 | Projet créé. Le project_id est renvoyé dans le corps de la réponse. | Stocker le project_id pour interroger le statut et le rapport ensuite. |
400 | Requête malformée. | Vérifier que chaque URL commence par http:// ou https://, et que project_name fait entre 1 et 255 caractères. |
401 | Clé API absente ou invalide. | Vérifier le header X-API-Key. Attention : ce n'est pas le header Authorization. |
403 | Permission refusée ou crédits insuffisants. | Contrôler le solde via /credits/balance avant de créer le projet, en tenant compte du triplement du coût en Apex Mode. |
404 | Ressource introuvable, typiquement un project_id inexistant. | Confirmer le project_id via /projects/list. |
429 | Limite de débit dépassée : plus de 100 requêtes par minute. | Espacer les appels et réessayer avec un délai progressif. |
500 | Erreur serveur côté Rapid URL Indexer. | Réessayer après quelques minutes. Si l'erreur persiste, contacter le support. |
// questions
API Rapid URL Indexer : questions fréquentes
Comment s'authentifier sur l'API Rapid URL Indexer ?
Par un header X-API-Key contenant la clé récupérée sur la page My Projects du compte. Ce n'est pas le header Authorization standard, et c'est la cause la plus fréquente des erreurs 401 sur cette API. La clé s'utilise telle quelle, sans préfixe ni encodage. Toutes les routes sont préfixées par /wp-json, l'API étant servie par WordPress.
Combien d'URLs peut-on soumettre par appel à l'API Rapid URL Indexer ?
9 999 URLs maximum par projet, et non 10 000 : le compte rond fait échouer la requête en erreur 400. Il n'existe en revanche aucune limite sur le nombre total d'URLs soumises tous projets confondus. L'éditeur recommande de regrouper les URLs par projet cohérent plutôt que de tout envoyer en un bloc, pour garder un suivi lisible dans les rapports. Le débit est plafonné à 100 requêtes par minute et par clé, au-delà l'API renvoie un 429.
Comment activer l'Apex Mode via l'API ?
En passant apex_mode_enabled à true dans le corps de la requête de création de projet. Le crawl Googlebot est alors visé en environ 5 minutes et jusqu'à 3 tentatives d'indexation sont effectuées, pour 3 crédits par URL au lieu d'un. Attention à la garantie : en Apex Mode, seul 1 crédit sur 3 est recrédité si l'URL reste non indexée à J+14, alors que le mode standard recrédite la totalité. Réserver l'option aux URLs où la vitesse a une valeur réelle. Voir notre page dédiée à l'Apex Mode.
L'API Rapid URL Indexer permet-elle le drip-feed ?
Non, aucun paramètre d'étalement n'existe dans l'API : les URLs d'un projet sont soumises en une fois. Le plugin WordPress officiel propose bien un plafond d'URLs sur 24 heures glissantes avec mise en file du surplus, mais c'est un limiteur de débit, pas un vrai drip-feed programmé. Pour étaler des soumissions sur plusieurs jours en tier 2 ou 3, SpeedyIndex expose drip_feed et drip_feed_days directement en paramètre d'API, sur 2 à 30 jours. À défaut, l'étalement doit être géré côté client en planifiant plusieurs projets successifs.
Faut-il l'API si on utilise WordPress ?
Non, et c'est l'avantage de Rapid URL Indexer sur SpeedyIndex. Le plugin officiel gratuit publié sur wordpress.org fait le travail sans écrire une ligne de code : coller la clé API dans Réglages suffit pour que chaque post ou page publié ou mis à jour parte automatiquement à l'indexation. L'API garde son intérêt pour les cas que le plugin ne couvre pas : soumettre des URLs externes comme des backlinks, piloter plusieurs sites clients depuis un même outil, ou brancher l'indexation sur un CMS non WordPress. Voir notre guide du plugin WordPress Rapid URL Indexer.
Rédacteur principal, SEO & indexation
Praticien SEO depuis 2014. Spécialisé indexation Google et netlinking pour sites e-commerce et SaaS B2B.
Sources
Documentation vérifiée sur les sources primaires de l'éditeur. Les paramètres d'une API évoluent : en cas d'écart avec la documentation officielle, celle-ci fait foi. Signaler un écart via la page contact.
// pour aller plus loin
Pages connexes
Avis Rapid URL Indexer
Le test complet : tarifs réels par URL, garantie, points forts et limites.
Indexer ses backlinks rapidement
La méthode complète, dont le rôle des indexeurs dans une stratégie de netlinking.
Apex Mode
Crawl visé en 5 minutes pour 3 crédits par URL, mais garantie réduite à 1 crédit sur 3. Quand l'option vaut son coût.
Plugin WordPress
Installation et réglages du plugin officiel gratuit, et les deux options qui font grimper la facture sans contrepartie.
IndexNow : l'API gratuite
L'alternative gratuite pour Bing et Yandex, et pourquoi elle ne remplace pas un indexeur sur Google.
Comparatif des indexeurs
Le classement complet, prix par URL et garanties comparés.
Forcer l'indexation Google
Les leviers gratuits à épuiser avant de payer un service d'indexation.