Champs de l'article a renvoyer, separes par des virgules. Les noms inconnus sont ignores. Incluez content_html pour demander le corps, omis par defaut.

fields[posts]

Renvoyer uniquement les articles de l'auteur spécifié.

filter[author_id]

filter[content_type]

Renvoyer uniquement les articles publiés à cette date ou après. (format ISO 8601)

filter[published_at_gte]

Renvoyer uniquement les articles publiés à cette date ou avant. (format ISO 8601)

filter[published_at_lte]

filter[published]

Filtrer par slug. Renvoie uniquement les articles correspondant exactement.

filter[slug]

Renvoyer uniquement les articles ayant le tag spécifié.

filter[tag_id]

Spécifiez les ressources liées à inclure, séparées par des virgules

Valeurs disponibles pour Posts :
- `tags` - Tags de l'article
- `authors` - Auteurs de l'article


include

Éléments par page Le format JSON:API `page[size]` est egalement accepte.

limit

order

Numéro de page (à partir de 1) Le format JSON:API `page[number]` est egalement accepte.

page

sort

Attributs de l'API key et scopes accordés.

Liste des permissions accordées à l'API key

Identifiant de type de ressource. Toujours `api_keys`.

Charge utile de la ressource auteur à créer.

Ressources d'auteur disponibles dans le blog.

Nom d'affichage de l'auteur
- Nom affiché sur le blog
- Peut utiliser un pseudonyme ou un nom de plume


URL de l'image de profil
- Recommandé de téléverser vers le stockage Inblog
- Ratio : 1:1 (carré)
- Taille recommandée : 400x400px


Identifiant de type de ressource
- Valeur fixe conforme au standard JSON:API
- Toujours "authors"


Charge utile de la ressource auteur à mettre à jour.

Code de langue du blog (ISO 639-1)
- Par defaut : ko (coreen)
- Utilise dans l'attribut lang du HTML


Statut de vérification du domaine personnalisé

URL du favicon
- Taille : 32x32px ou 64x64px
- Format ICO ou PNG


ID de mesure Google Analytics 4 connecte au blog

Indique si Google Search Console est actuellement connecte

URL de l'image du logo
- Taille recommandée : 200x50px (paysage)
- PNG à fond transparent recommandé


URL du logo (deprecie, utilisez logo a la place)

URL de l'image a la une Open Graph
- Image affichee lors du partage sur les reseaux sociaux
- Taille recommandee : 1200x630px


Plan d'abonnement (lecture seule)
- free : plan gratuit
- team : plan Team
- enterprise : plan Enterprise


URL de la propriete Google Search Console liee a ce blog

Decalage horaire par rapport a UTC (en heures)
- Coree : 9 (UTC+9)
- Japon : 9 (UTC+9)
- Est des Etats-Unis : -5 (UTC-5)


Date de derniere mise a jour du blog (ISO 8601)

Identifiant de type de ressource
- Valeur fixe conforme au standard JSON:API
- Toujours "blogs"


Charge utile de la ressource blog a mettre a jour.

Texte affiché dans l'élément de navigation de l'en-tête

URL de destination ouverte lorsque l'élément de navigation est cliqué

Couleur d'arrière-plan de la bannière au format hexadécimal

Texte d'accompagnement affiché sous le titre de la bannière

Couleur du titre de la bannière au format hexadécimal

Texte du pied de page affiché en bas du blog

Éléments de navigation de l'en-tête affichés en haut du blog

Charge utile de style JSON:API pour la mise à jour des paramètres d'interface personnalisée.

Fournissez n'importe quel sous-ensemble de champs à mettre à jour. Seuls les champs inclus seront modifiés.

Charge utile au format JSON:API pour ajouter un domaine personnalisé.

Domaine personnalisé à connecter. Fournissez uniquement le nom d'hôte, sans protocole.

Domaine personnalisé qui a été enregistré sur le blog

Réponse brute de création de domaine Vercel. L'ensemble exact des champs varie selon l'état actuel du domaine Vercel.

État de vérification initial enregistré pour le domaine

Indique si le domaine personnalisé a été supprimé avec succès

Indique si un domaine personnalisé est actuellement configuré pour le blog

Domaine personnalisé actuellement configuré

Réponse brute du statut projet-domaine Vercel

Réponse brute de la tentative de vérification Vercel renvoyée lorsque le domaine n'est pas encore vérifié

État de vérification stocké dans l'enregistrement du blog

Ressources de formulaire pour la page actuelle.

Champs du formulaire renvoyés par l'API.

Heure de création du formulaire (format ISO 8601)

Relations entre le formulaire et les réponses qui lui ont été soumises.

Relation vers les réponses créées à partir de ce formulaire.

Identifiant du type de ressource. Toujours `forms`.

Ressources de réponse au formulaire pour la page actuelle.

Champs de la réponse au formulaire soumise.

Heure de soumission de la réponse (format ISO 8601)

Adresse e-mail de l'auteur de la soumission

Données de la réponse (objet JSON). Les clés sont résolues en libellés de champs du formulaire (dataLabel ou label)

Fuseau horaire de l'auteur de la soumission

Relations vers le formulaire, l'article et le blog associés.

Relation vers le blog propriétaire de la réponse au formulaire.

Relation vers le formulaire qui a collecté cette réponse.

Relation vers l'article où le formulaire était intégré, lorsque disponible.

Identifiant du type de ressource. Toujours `form_responses`.

Métadonnées de version JSON:API incluses dans chaque réponse JSON:API.

URI de redirection qui sera utilisé pour le callback

Charge utile de la ressource d'article à créer.

Ressources d'articles pour la page courante.

Titre de l'article (inclus lorsque include=title)

Lignes de métriques de trafic par article pour la plage de dates demandée.

Champs principaux du post renvoyés par l'API.

URL canonique (pour éviter le contenu dupliqué)

"HTML du contenu de l'article (généré avec l'éditeur TipTap)

**Méthode de génération :**

- Inblog utilise un éditeur WYSIWYG basé sur TipTap pour générer le HTML

- Conversion HTML en temps réel via la méthode editor.getHTML()

- Tout le contenu est géré en unités de blocs structurées

**Balises HTML de base :**

- Paragraphe : `<p>`

- Titres : `<h2>`, `<h3>`, `<h4>` (h1, h5, h6 non pris en charge)

- Listes : `<ul>`, `<ol>`, `<li>` (imbrication prise en charge)

- Styles de texte : `<strong>`, `<em>`, `<u>`, `<s>`, `<code>`

- Liens : `<a>` (sans attribut rel, nofollow supprimé)

- Citation : `<blockquote>`

- Filet horizontal : `<hr>`

- Saut de ligne : `<br>`

**Mise en forme avancée :**

- Surlignage : `<mark>` (plusieurs couleurs prises en charge)
- Couleur du texte : `<span style="color: #hex;">` - Alignement du texte : `style="text-align: left|center|right;"`
- Bloc de code : `<pre><code class="language-*">` (coloration syntaxique prise en charge)

**Tableaux :**

- `<table>`, `<thead>`, `<tbody>`, `<tr>`, `<th>`, `<td>`
- Colonnes redimensionnables (attribut colwidth)
- Habillage automatique avec défilement horizontal

**Blocs personnalisés (distingués par l'attribut data-type) :**

- Image : `<img data-type="imageBlock">` - Bloc d'image unique
- Grille d'images : `<div data-type="imageGrid">` - Disposition en grille
- Carrousel d'images : `<div data-type="imageCarousel">` - Format diaporama
- Encadré : `<div data-type="callOut">` - Boîte de mise en évidence
- Bouton de lien : `<div data-type="linkButton">` - Bouton CTA
- Signet : `<div data-type="bookmark">` - Aperçu d'URL

**Prise en charge des intégrations :**

- YouTube : `<div data-type="youtube" data-youtube-video-id="*">`
- Services de formulaire :
  - Google Forms : `<div data-type="googleForm">`
  - HubSpot : `<div data-type="hubspot">`
  - Tally : `<div data-type="tally">`
  - Typeform : `<div data-type="typeform">`
- Bloc de code HTML : `<section data-type="code-block"><div>...</div></section>` - Insertion de HTML personnalisé (iframes, etc.). Vous devez utiliser la balise `section` + `data-type="code-block"` + un conteneur interne `<div>` pour correspondre au schéma tiptap. `<div data-type="htmlCodeBlock">` ne fonctionnera PAS

**Sécurité et limitations :**

- Les balises `<script>` sont automatiquement supprimées (prévention XSS)
- Les images doivent utiliser le CDN Inblog (source.inblog.dev)
- Les liens vers des feuilles de style externes sont restreints
- Les iframes ne sont autorisées que pour les services d'intégration permis

**Exemple :**

```html
<h2>Title</h2>
<p>Regular text with <strong>emphasis</strong>, <em>italic</em></p>
<div data-type="imageBlock" data-width="wide">
  <img src="https://source.inblog.dev/..." alt="Description">
</div>
<div data-type="callOut" data-emoji="💡">
  <p>Important information</p>
</div>
<pre><code class="language-javascript">console.log('Hello');</code></pre>
```\n"


Couleur de fond du bouton CTA (couleur hex)
- Code hex à 6 chiffres (#RRGGBB)
- Par défaut : couleur du thème du blog


Type de couleur de fond du bouton CTA
- custom : utilise la couleur personnalisée spécifiée dans cta_color
- preset : utilise la couleur prédéfinie du blog
- default : utilise la couleur du thème du blog


URL vers laquelle naviguer lorsque le bouton CTA est cliqué

Couleur du texte du bouton CTA (couleur hex)
- Code hex à 6 chiffres (#RRGGBB)
- Par défaut : #ffffff (blanc)


Type de couleur du texte du bouton CTA
- custom : utilise la couleur personnalisée spécifiée dans cta_text_color
- default : calculée automatiquement à partir du contraste du fond du bouton (#ffffff ou #000000)
- Envoyer cta_text_color sans définir ce champ sur 'custom' peut entraîner le remplacement de la couleur par l'éditeur


Scripts personnalisés insérés dans l'article

Description résumée de l'article (meta description SEO)

ID du formulaire à rattacher à l'article. Définir sur null pour retirer le formulaire.

Meta description SEO (affichée dans les résultats de recherche)

Meta title SEO (affiché dans l'onglet du navigateur)

Date de publication de l'article (format ISO 8601)

Identifiant unique compatible avec les URL. Seuls les lettres, les chiffres et les traits d'union sont autorisés

Titre de l'article (recommandé : moins de 60 caractères pour le SEO)

Relations de l'article vers les tags et les auteurs.

Identifiant de type de ressource
- Valeur fixe conformément au standard JSON:API
- Toujours "posts"


Ressources liées incluses avec l'article, telles que les tags ou les auteurs.

Lignes de série temporelle de trafic pour un seul article.

Charge utile de la ressource post a mettre a jour.

Charge utile de la ressource redirection a creer.

Ressources de regles de redirection pour le blog actuel.

Champs de la regle de redirection renvoyes par l'API.

Chemin source (source de la redirection)
- Doit commencer par /
- Doit etre unique
- Les caracteres generiques ne sont pas pris en charge


Type de redirection
- 307 : Temporary Redirect
- 308 : Permanent Redirect


Chemin cible (destination de la redirection)
- Doit commencer par /
- Les URL externes sont egalement autorisees (http:// ou https://)


Identifiant de type de ressource
- Valeur fixe selon le standard JSON:API
- Toujours "redirects"


Charge utile de la ressource redirect à mettre à jour.

Lignes de référents classées par nombre de visites.

Nombre de visites provenant de cette source

Identifiant de ressource liée, tableau d'identifiants de ressource, ou `null`.

ID de ressource (obligatoire)
- Format chaîne de caractères
- Doit être unique au sein de son type

**Important :** La valeur d'exemple (123) est un échantillon. Pour une utilisation réelle :
- Récupérer les ID de tag : `GET /v1/tags`
- Récupérer les ID d'auteur : `GET /v1/authors`

L'utilisation d'ID inexistants entraînera une erreur 400.


Type de ressource (obligatoire)
- posts, tags, authors etc.


Code d'autorisation OAuth renvoyé par Google

URI de redirection utilisé dans le flux OAuth. Omettez-le pour utiliser le callback par défaut du tableau de bord.

Indique si Search Console est désormais connecté

Indique si l'échange de token et l'opération d'enregistrement ont réussi

Indique si Search Console reste connecté après l'opération

Indique si l'opération de déconnexion a réussi

Indique si Search Console est actuellement connecté

URL de la propriété Search Console connectée. Renvoie `null` lorsqu'aucune connexion n'est établie.

Lignes de performance Search Console pour la plage de dates demandée.

Position moyenne dans les résultats de recherche

Charge utile de la ressource de tag à créer.

Nom du tag (sensible à la casse, doit être unique)

Identifiant unique compatible avec les URL
- Seuls les lettres minuscules, les chiffres et les traits d'union sont autorisés
- Peut être généré automatiquement à partir du nom


Identifiant du type de ressource
- Valeur fixe conforme au standard JSON:API
- Toujours "tags"


Charge utile de la ressource de tag à mettre à jour.

Lignes de série temporelle de trafic pour la plage de dates demandée.

URL publique de la ressource téléversée

Ressources de blog accessibles pour l'utilisateur actuel.

Attributs du blog visibles par l'utilisateur authentifié.

Langue principale configurée pour le blog

Indique si l'utilisateur actuel est autorisé à publier des posts sur ce blog

Domaine personnalisé connecté, si un est configuré

Permission de l'utilisateur actuel sur le blog

ID numérique du blog sérialisé sous forme de chaîne de caractères

Identifiant de type de ressource. Toujours `blogs`.

Utilisez la API key comme jeton Bearer.

Format : `Authorization: Bearer YOUR_API_KEY`

Les API keys peuvent être générées depuis le tableau de bord inblog.


Utilisez un JWT utilisateur signé comme jeton Bearer.

Format : `Authorization: Bearer USER_JWT`

Ce schéma est utilisé pour les endpoints liés à l'utilisateur tels que `/user/blogs`.


Inblog Support

Gerez le contenu de votre blog avec l'API Inblog.

## 🚀 Pour commencer

### 1. Obtenir une API key
Recuperez votre API key depuis le tableau de bord :
1. Connectez-vous au [Inblog Dashboard](https://inblog.ai/dashboard)
2. Accedez a Settings → API Keys
3. Cliquez sur le bouton "Create New API Key"
4. Selectionnez les permission scopes requis
5. Conservez votre API key en lieu sur

### 2. Premiere requete
```bash
curl -X GET https://api.inblog.ai/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 3. Utiliser les outils developpeur npm
Si vous preferez ne pas appeler l'API manuellement, installez la CLI :
```bash
npm install -g @inblog/cli
inblog auth login
```
Pour les assistants de code IA, installez les AI Skills :
```bash
npx @inblog/ai-skills
```
La CLI gere les posts, les images, les tags, les auteurs, les redirections, les formulaires, les analytics et les parametres du blog depuis votre terminal. Les AI Skills installent les workflows Inblog pour des outils tels que Codex, Claude Code, Cursor, GitHub Copilot et Gemini.
Consultez le [guide des outils developpeur](/docs/developer-tools/inblog-cli-and-ai-skills).

### 4. Content-Type
- **Request** : `Content-Type: application/json` ou `application/vnd.api+json`
- **Response** : `Content-Type: application/vnd.api+json`

## 📋 Principales fonctionnalites

- **Post Management** : creer, mettre a jour, supprimer et publier des posts
- **Tags and Authors** : gerer les categories et les informations des auteurs
- **Blog Settings** : modifier les parametres de base
- **URL Redirects** : configurer des redirections 307 (temporaires) et 308 (permanentes)
- **Forms & Responses** : consulter les formulaires de capture de leads et les donnees de soumission
- **JSON:API Standard** : format de reponse coherent

## 🔐 Authentication

Toutes les requetes API necessitent une authentification par Bearer token via l'en-tete Authorization :

```
Authorization: Bearer YOUR_API_KEY
```
## 📚 En savoir plus

- [JSON:API Specification](https://jsonapi.org/)

Proprietary

Inblog API

Récupère tous les profils d'auteurs enregistrés dans le blog.

Liste des auteurs récupérée avec succès

Retire les associations de l'auteur des articles de ce blog. Le profil de l'auteur lui-même n'est pas supprimé.

Récupère les informations de profil d'un auteur spécifique.

Met à jour les informations de profil d'un auteur.

**Champs modifiables :**
- author_name : Nom d'affichage de l'auteur
- avatar_url : URL de l'image de profil

**Traitement des images :**
Les URL des images de profil sont téléversées vers le stockage Inblog R2 par défaut.
Pour conserver les URL d'origine, utilisez le paramètre de requête `preserve_external_images=true`.


Conserve les URL d'images externes au lieu de les téléverser vers le stockage R2

preserve_external_images

Met à jour les informations de profil d'un auteur à l'aide de PUT.

**Champs modifiables :**
- author_name : Nom d'affichage de l'auteur
- avatar_url : URL de l'image de profil

**Traitement des images :**
Les URL des images de profil sont téléversées vers le stockage Inblog R2 par défaut.
Pour conserver les URL d'origine, utilisez le paramètre de requête `preserve_external_images=true`.


Récupère les métriques de performance par article, incluant les visites, les clics, le trafic organique et le taux de conversion.

Date de début (YYYY-MM-DD). Par défaut, il y a 28 jours.

start_date

Date de fin (YYYY-MM-DD). Par défaut, aujourd'hui.

end_date

Définissez sur "title" pour inclure les titres des articles dans la réponse

Métriques des articles récupérées avec succès

Obtenir les métriques de performance des articles

Récupère les données de trafic dans le temps pour un article spécifique, avec une granularité quotidienne ou horaire.

Intervalle de temps pour l'agrégation des données

interval

Données de trafic de l'article récupérées avec succès

Récupère l'analyse des sources de trafic pour un article spécifique, affichant les données de référents.

Sources de trafic de l'article récupérées avec succès

Obtenir les sources de trafic d'un article

Récupère l'analyse des sources de trafic affichant les données de référents triées par nombre de visites.

Sources de trafic récupérées avec succès

Obtient les données de trafic à l'échelle du blog avec une granularité quotidienne ou horaire. Inclut les visites, les clics, le trafic organique et la répartition par type de page.

type

Données de trafic récupérées avec succès

Récupère les paramètres actuels de personnalisation de la bannière et de l'UI de votre blog.

Paramètres d'UI récupérés avec succès

Obtenir les paramètres de bannière et d'UI

Met à jour les paramètres de bannière et de personnalisation de l'interface. Seuls les champs fournis sont mis à jour.

Paramètres d'interface mis à jour avec succès

Mettre à jour les paramètres de bannière et d'interface

Supprime le domaine personnalisé de votre blog. Le blog reviendra au sous-domaine par défaut.

Domaine personnalisé supprimé avec succès

Vérifie la configuration actuelle du domaine personnalisé et le statut de vérification DNS.

Statut du domaine récupéré avec succès

Ajoute un domaine personnalisé à votre blog. Renvoie la configuration du domaine, y compris les paramètres DNS Vercel requis pour la vérification.

Domaine personnalisé ajouté avec succès

Récupère les informations sur le blog connecté à l'API key actuelle.

Met à jour les paramètres de base comme le nom du blog, la description, le logo, le favicon et l'image à la une.

**Traitement des images :**
Les URL du logo, du favicon et de l'image à la une sont téléversées vers le stockage Inblog R2 par défaut.
Pour conserver les URL d'origine, utilisez le paramètre de requête `preserve_external_images=true`.


Mettre à jour les paramètres de mon blog

Met à jour les paramètres de base comme le nom du blog, la description, le logo, le favicon et l'image à la une à l'aide de PUT.

**Traitement des images :**
Les URL du logo, du favicon et de l'image à la une sont téléversées vers le stockage Inblog R2 par défaut.
Pour conserver les URL d'origine, utilisez le paramètre de requête `preserve_external_images=true`.


Mettre à jour les paramètres de mon blog (PUT)

Échange un code d'autorisation OAuth contre des jetons afin de finaliser la connexion à Search Console.

Déconnecte Google Search Console de votre blog. Supprime les jetons OAuth stockés.

Obtient les données de performance de recherche au niveau des mots-clés depuis Google Search Console. Renvoie les clics, les impressions, le CTR et la position moyenne pour chaque mot-clé.