S
API Ready

Intégration Sanity

Publiez des contenus optimisés pour le SEO sur votre site propulsé par Sanity grâce à la Mutations API, pour une diffusion headless.

Sanity Mutations API (HTTP)

Sanity est un CMS headless moderne qui donne aux développeurs un contrôle total sur la structure et la diffusion des contenus. Il est apprécié avec les frontends Next.js, Gatsby et Nuxt, et se montre extrêmement puissant pour les sites axés sur le contenu.

GetRanked se connecte à la Mutations API de Sanity pour créer des documents dans votre dataset. Nous publions des contenus structurés conformes à votre schéma Sanity, notamment du texte enrichi au format Portable Text, des références vers d’autres documents et des champs personnalisés.

Comme Sanity est headless, c’est votre frontend qui décide de l’affichage des contenus. GetRanked se concentre sur la création des contenus, votre frontend Next.js ou Gatsby sur leur présentation. Cette séparation vous permet d’obtenir les meilleures performances SEO avec votre frontend sur mesure, pendant que GetRanked assure la production de contenus à grande échelle.

Ce dont vous aurez besoin

Project ID

L’ID de votre projet Sanity (disponible sur sanity.io/manage)

Dataset

Le nom du dataset (généralement 'production')

API Token

Un jeton d’écriture avec les droits Editor

Type de document

Le nom du type de schéma des articles de blog (p. ex. 'post')

Guide de configuration étape par étape

1

Connectez-vous à Sanity Manage

Rendez-vous sur sanity.io/manage et sélectionnez votre projet.

2

Récupérez votre Project ID et votre dataset

Votre Project ID s’affiche dans l’en-tête du projet. Le nom de votre dataset se trouve sous 'Datasets' (généralement 'production').

3

Créez un API Token

Allez dans API → Tokens → 'Add API Token'. Nommez-le 'GetRanked', définissez les droits sur 'Editor' et créez-le. Copiez immédiatement le jeton.

4

Notez le type de schéma de votre blog

Cherchez dans vos fichiers de schéma Sanity (généralement dans le dossier schemas/) le type de document utilisé pour les articles. Noms courants : 'post', 'article', 'blogPost'.

5

Établissez la connexion dans GetRanked

Saisissez votre Project ID, votre dataset, votre API Token et le type de document dans l’intégration Sanity de GetRanked.

6

Associez les champs et testez

Associez les champs de contenu aux champs de votre schéma Sanity (titre, slug, corps, extrait, etc.). Testez avec un document en brouillon.

Ce que GetRanked publie sur Sanity

  • Documents suivant la structure des champs de votre schéma
  • Texte enrichi au format Portable Text (block content)
  • Champs slug avec des slugs générés automatiquement et compatibles avec les URL
  • Références vers les documents de catégorie/tag
  • Champs SEO (méta-titre, description) si votre schéma les inclut
  • État brouillon ou publié selon la configuration

Conseils pour de meilleurs résultats

Ajoutez des champs SEO (metaTitle, metaDescription) à votre schéma de blog si ce n’est pas déjà fait.

Vérifiez que votre frontend affiche correctement le Portable Text pour le SEO (titres, liens, etc.).

Utilisez les requêtes GROQ de Sanity sur votre frontend pour construire le maillage interne et les articles connexes.

Configurez un webhook dans Sanity pour relancer la génération du frontend lorsque GetRanked publie de nouveaux contenus.

Prêt à bien classer votre site Sanity ?

Commencez dès aujourd’hui à publier sur Sanity des contenus générés par IA et optimisés pour le SEO. Aucune carte bancaire requise.