API publique
Intégrer LinkPost depuis tes propres outils via l'API REST v1
L'API publique LinkPost te permet de piloter LinkPost depuis tes propres scripts, outils no-code (n8n, Zapier, Make) ou services maison. Génère des posts, publie, lis tes stats, analyse un texte, prédis sa viralité — tout ce que tu fais dans l'app, sans ouvrir l'app.
L'API est en v1 et montée sur https://www.linkpost.gg/api/v1.
Démarrer en 2 minutes
1. Créer une clé API
- Va dans Paramètres → Clés API dans l'app
- Clique sur Créer une clé
- Donne-lui un nom (ex:
n8n-production) et choisis les scopes dont tu as besoin - Copie la clé immédiatement — tu ne la reverras plus (format
lp_live_xxx…)
Tu peux avoir jusqu'à 10 clés actives par compte. Révoque celles que tu n'utilises plus.
2. Tester avec curl
curl https://www.linkpost.gg/api/v1/account/profile \
-H "Authorization: Bearer lp_live_VOTRE_CLE"Si la clé est valide et a le scope account:read, tu récupères ton profil. Tu es prêt.
Authentification
Toutes les requêtes passent un header Authorization: Bearer lp_live_xxx.
- Sans header ou préfixe invalide → 401
Missing or invalid Authorization header - Clé inconnue → 401
Invalid API key - Clé révoquée → 401
API key has been revoked - Clé expirée → 401
API key has expired - Scope manquant pour l'endpoint → 403
Missing required scope: <scope>
Scopes
Chaque clé porte un ensemble de scopes qui déterminent ce qu'elle peut faire. Choisis le minimum nécessaire.
| Scope | Permet |
|---|---|
posts:generate | Générer des propositions de posts |
posts:read | Lire tes posts publiés et leurs stats |
posts:write | Créer, modifier, supprimer des drafts |
posts:schedule | Programmer un draft à une date future |
posts:publish | Publier un post immédiatement sur LinkedIn |
account:read | Lire ton profil, solde de crédits, profils d'écriture |
account:write | Modifier tes profils d'écriture, activer/désactiver |
media:read / media:write | Lire / uploader des médias |
infographics:read / infographics:write / infographics:generate / infographics:export | Lire / créer / générer / exporter des infographies |
Endpoints principaux
L'API suit une structure REST classique. Voici les endpoints les plus utilisés :
Génération & édition
| Méthode | Endpoint | Description | Coût |
|---|---|---|---|
POST | /generate | Génère des propositions de post à partir d'un prompt. Sauve un draft par défaut. | 1 crédit |
POST | /analyze | Détecte les règles et tactiques dans un texte. | 1 crédit |
POST | /rewrite | Réécrit un texte selon une instruction (plus punchy, plus court, etc.) | 1 crédit |
POST | /virality | Prédit un score de viralité pour un texte. | Gratuit |
Drafts & posts
| Méthode | Endpoint | Description |
|---|---|---|
GET | /drafts | Liste tes drafts et posts programmés |
POST | /drafts | Crée un draft (optionnellement programmé) |
GET | /posts | Liste tes posts publiés avec métriques d'engagement |
GET | /calendar?from=YYYY-MM-DD&to=YYYY-MM-DD | Vue consolidée du calendrier éditorial |
Inspiration & compte
| Méthode | Endpoint | Description |
|---|---|---|
GET | /inspirations | Recherche dans ta base de posts inspirants (filtres : search, minLikes, format) |
GET | /account/profile | Infos du compte + crédits + profils d'écriture |
GET | /credits | Solde et historique des transactions de crédits |
GET | /writing-profiles | Liste des profils d'écriture |
POST | /writing-profiles/:id/activate | Active un profil d'écriture pour les prochaines générations |
Exemple complet — générer un post
curl -X POST https://www.linkpost.gg/api/v1/generate \
-H "Authorization: Bearer lp_live_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Comment structurer un carrousel LinkedIn qui convertit",
"numProposals": 3,
"saveDraft": true,
"scheduledAt": "2026-05-01T08:00:00Z"
}'Réponse (simplifiée) :
{
"proposals": ["…", "…", "…"],
"draftId": "drft_abc123",
"creditsRemaining": 47
}Rate limits
Les clés sont rate-limitées par identifiant de clé :
- Endpoints généraux : quota par défaut adapté à un usage normal
/generate: quota plus strict (génération LLM coûteuse)
En cas de dépassement, tu reçois un 429 avec un header indiquant quand réessayer. Prévois un backoff exponentiel côté client.
Gestion des clés
Depuis Paramètres → Clés API, tu peux :
- Voir toutes tes clés actives avec leur préfixe, leurs scopes, et la date de dernière utilisation
- Créer une nouvelle clé (max 10)
- Révoquer une clé (effet immédiat, irréversible)
- Définir une date d'expiration optionnelle à la création
La clé complète n'est affichée qu'une seule fois à la création. Si tu la perds, révoque-la et recrée-en une.
Voir aussi
- Serveur MCP pour Claude Code — Piloter l'API depuis Claude Code sans écrire de code HTTP
- Crédits — Comprendre les coûts en crédits des endpoints de génération