L'API MisterGoodLink
Pilotez le catalogue, vos commandes et vos ventes directement depuis vos outils. Une API REST simple, authentifiée par clé, avec des réponses JSON normalisées.
Activer mon accès APIUne API par compte, pensée pour l'automatisation
Chaque client MisterGoodLink dispose de sa propre clé API. Elle donne accès à une API REST (V2) qui reprend la logique de la plateforme : recherche dans le catalogue, passage de commandes, gestion de vos sites et validation de vos ventes.
L'API est idéale pour automatiser vos campagnes : connecter votre CRM ou vos tableaux de bord, industrialiser vos commandes, synchroniser vos spots d'éditeur, ou alimenter vos propres outils internes.
Ce que permet l'API
Les mêmes actions que sur la plateforme, en accès programmatique.
Explorer le catalogue
Recherchez parmi des milliers de spots avec les filtres avancés : Trust Flow, Citation Flow, domaines référents, trafic, langue, thématique, Google News, GEO…
Passer des commandes
Créez des commandes SEO ou GEO réglées avec votre porte-monnaie (ancre, URL, planification, thématiques sensibles), et suivez leur statut.
Gérer vos sites (éditeur)
Ajoutez et mettez à jour vos sites/spots (langue, prix, catégories, options GEO, thématiques sensibles) et suivez vos ventes.
Suivre votre compte
Consultez le solde de votre porte-monnaie (budget annonceur) et, pour un éditeur, vos gains disponibles — utile avant chaque commande.
Trois étapes pour démarrer
- Activez l'accès API depuis votre espace, rubrique Mon compte > API.
- Générez votre clé (affichée une seule fois) et conservez-la précieusement.
- Appelez les endpoints en passant votre clé dans l'en-tête
Authorization.
Toutes les requêtes se font sur l'URL de base https://app.mistergoodlink.com/api/v2/ et s'authentifient par jeton Bearer :
# Exemple : consulter mon compte (solde du porte-monnaie)curl -H "Authorization: Bearer sk_live_xxxxxxxx" \
https://app.mistergoodlink.com/api/v2/account
Les réponses sont des JSON normalisés de la forme :
{ "results": [ ... ], "message": "", "code": 200, "count": 0 }
Principaux endpoints
| Méthode | Endpoint | Rôle |
|---|---|---|
| GET | /account | Mon compte : solde du porte-monnaie (et gains éditeur) |
| GET | /sites | Recherche dans le catalogue (filtres TF, CF, RD, trafic, langue…) |
| GET | /sites/{id} | Détail d'un site vendable |
| POST | /orders | Passer une commande SEO / GEO réglée au porte-monnaie |
| GET | /orders | Suivi de mes commandes |
| POST/PUT | /my-sites | Éditeur : ajouter / modifier mes sites |
| GET/POST | /sells | Éditeur : suivre et valider mes ventes |
La documentation complète et à jour est disponible dans votre espace, sur la page API, une fois l'accès activé. L'usage de l'API est encadré par les CGUS.