Start Free No credit card required
Pour les Développeurs

API
Reference

Documentation complète de l'API REST RankPress pour intégrer la génération de contenu IA dans vos applications.

Version API v1.0 Stable

API RESTful

Une API simple et puissante pour automatiser votre création de contenu SEO.

Simple & Intuitive

API REST standard avec authentification Bearer token. Facile à intégrer dans n'importe quelle stack technologique.

Sécurisée

HTTPS obligatoire, tokens JWT, rate limiting et webhooks signés HMAC-SHA256 pour une sécurité maximale.

Asynchrone

Les générations sont traitées de manière asynchrone. Recevez les résultats via webhook quand c'est prêt.

Base URL

Toutes les requêtes API doivent être envoyées à cette URL de base :

https://api.rankpress.com/v1

Authentification

Utilisez votre API key dans le header Authorization pour authentifier vos requêtes :

Authorization: Bearer your_api_key_here Content-Type: application/json

Vous pouvez obtenir votre API key depuis votre tableau de bord RankPress.

Points d'Accès

Liste complète des endpoints disponibles dans l'API RankPress.

POST /pages/generate Générer un nouvel article
Paramètres
Paramètre Type Description
title requis string Titre de l'article à générer
content_angle optionnel string Type d'article : tutorial, review, comparison, list, news, how-to
language optionnel string Code langue ISO (fr, en, es, etc.). Défaut: fr
webhook_url optionnel string URL de callback pour recevoir l'article généré
Exemple de requête
POST /v1/pages/generate { "title": "Comment optimiser son SEO en 2025", "content_angle": "tutorial", "language": "fr" }
Réponse
{ "success": true, "job_id": "job_abc123xyz", "status": "processing", "estimated_time": 180 }
GET /jobs/{job_id} Vérifier le statut d'une génération
Paramètres URL
Paramètre Type Description
job_id requis string ID du job retourné lors de la génération
Réponse
{ "job_id": "job_abc123xyz", "status": "completed", "progress": 100, "result": { "title": "...", "content": "...", "meta_description": "..." } }
GET /account Récupérer les infos du compte
Réponse
{ "account_id": "acc_123", "email": "user@example.com", "plan": "pro", "usage": { "articles_used": 12, "articles_limit": 30, "reset_date": "2025-01-15" } }
PUT /brand-context Mettre à jour la voix de marque
Paramètres
Paramètre Type Description
company_name optionnel string Nom de l'entreprise
industry optionnel string Secteur d'activité
tone optionnel string Ton : professional, friendly, authoritative
target_audience optionnel string Description de l'audience cible

Rate Limits

Limites de requêtes pour garantir la stabilité du service.

10
requêtes / minute
Par site connecté
100
requêtes / heure
Par compte
30
articles / mois
Plan Pro

Codes d'Erreur

Liste des codes d'erreur HTTP et leur signification.

400
Bad Request
Paramètres de requête invalides
401
Unauthorized
API key invalide ou manquante
403
Forbidden
Quota dépassé ou fonctionnalité non disponible
404
Not Found
Ressource non trouvée
429
Too Many Requests
Rate limit atteint, réessayez plus tard
500
Internal Server Error
Erreur serveur, contactez le support

Prêt à Intégrer ?

Obtenez votre API key et commencez à générer du contenu SEO depuis vos applications.