API SEO

L’API SEO Screpy est une API REST qui permet d’intégrer les données de projets, de crawls, de Rank Tracker, d’AI Visibility enregistrées, de pages, de monitoring et d’opportunités à vos produits, tableaux de bord et automatisations. Utilisez des réponses JSON structurées pour créer des flux SEO à partir des données accessibles à votre compte Screpy.

Commencer l’essai gratuit Voir les tarifs

TL;DR

Trop long ; non lu

Afficher le résumé

Qu’est-ce que l’API SEO Screpy ?

L’API SEO Screpy est une API REST destinée aux comptes membres payants. Elle expose les projets Screpy accessibles, les crawls terminés, Rank Tracker, les données AI Visibility enregistrées et la gestion des prompts, les comparaisons, les Core Web Vitals et la disponibilité via des requêtes JSON authentifiées. Elle est conçue pour les logiciels personnalisés, les systèmes de rapports et les automatisations ; utilisez une clé d’API REST, pas des identifiants OAuth MCP.

Accès et contexte du compte

Les clés d’API SEO Screpy se créent dans Paramètres → Applications connectées et sont envoyées comme jetons Bearer dans chaque requête REST.
L’API SEO Screpy est disponible pour les comptes membres payants et vérifie à chaque requête l’éligibilité, les droits des fonctionnalités et l’accès au projet.
L’API SEO Screpy liste les projets appartenant au compte authentifié ou partagés avec lui, en commençant par GET /projects.
L’API SEO Screpy renvoie l’utilisation du compte, les limites du forfait, le crédit restant et la disponibilité des fonctionnalités avant de lancer un crawl ou de traiter de grands résultats.

Projets, crawls et comparaisons

L’API SEO Screpy liste, crée, met à jour et supprime les projets accessibles pour les applications SEO personnalisées et les flux clients.
L’API SEO Screpy utilise un UID de projet pour les requêtes ciblées et renvoie un UID de crawl depuis la liste de crawls du projet sélectionné.
L’API SEO Screpy renvoie le statut du crawl, les résumés des crawls terminés, les indicateurs de santé, le nombre de problèmes et les totaux pour les flux SEO techniques.
L’API SEO Screpy compare deux crawls terminés afin qu’un tableau de bord ou une automatisation puisse étudier les changements entre deux références SEO techniques.

Enregistrements de crawl et données de monitoring

L’API SEO Screpy renvoie les pages, liens, images, résultats on-page et Quick Wins d’un crawl terminé sélectionné.
L’API SEO Screpy conserve ensemble les périmètres du projet et du crawl et prend en charge la pagination des grands résultats.
L’API SEO Screpy renvoie les Core Web Vitals et la disponibilité via des endpoints de santé distincts, car performance et disponibilité sont des signaux différents.
L’API SEO Screpy peut renvoyer data: null lorsqu’aucun contrôle de santé correspondant n’est disponible. Les intégrations doivent vérifier le monitoring avant de conclure à une panne du site.

Connectez votre produit aux données SEO.

Créez une clé d’API REST, découvrez les projets accessibles à votre compte et utilisez des identifiants de projet stables dans votre tableau de bord, votre automatisation ou votre application.

En savoir plus sur accès à l’api rest

Créer des clés d’API REST dans Paramètres → Applications connectées
Authentifier les requêtes avec un jeton Bearer
Découvrir les projets possédés et partagés avant de choisir un UID de projet
Consulter l’utilisation et les droits avant les flux coûteux

GET /v1/projects 200 OK

{
  "data": [
    {
      "uid": "prj_8f3a1",
      "name": "Example site",
      "domain": "example.com",
      "role": "owner"
    }
  ]
}

Lancez des flux de crawl depuis votre propre stack.

Connectez la gestion des projets, le statut des crawls, les résumés terminés et les comparaisons aux systèmes déjà utilisés par votre équipe pour les opérations SEO.

En savoir plus sur projets et crawls

Créer et gérer les projets Screpy accessibles via les endpoints REST
Utiliser les UID de projet et de crawl pour lire un site et un crawl sélectionnés
Suivre la progression, les indicateurs de santé, les problèmes et les totaux
Comparer des crawls terminés lors d’une release, migration ou modification de contenu

GET /v1/projects/{project_uid}/crawls 200 OK

{
  "data": [
    {
      "uid": "crw_42c91",
      "status": "completed",
      "health": { "score": 91 },
      "issues": { "critical": 2, "warnings": 14 }
    }
  ]
}

Transformez les données SEO en automatisations.

Utilisez les enregistrements de crawls terminés, les Quick Wins, les contrôles de performance et les signaux de disponibilité comme entrées structurées pour des rapports, notifications et flux SEO internes.

En savoir plus sur données de crawl et santé

Récupérer les pages, liens, images et résultats on-page d’un crawl terminé
Utiliser les Quick Wins pour les opportunités Search Console prioritaires
Paginer les grands jeux de données sans mélanger les crawls
Conserver Core Web Vitals et disponibilité avec les données à suivre

POST /v1/comparisons/crawls 200 OK

{
  "data": {
    "change": {
      "health_score": 4,
      "critical_issues": -3,
      "indexable_pages": 12
    }
  }
}

Endpoints de l’API SEO pour vos flux personnalisés

Construisez directement sur les données et flux Screpy importants pour votre produit : accès au compte, projets, crawls, Rank Tracker, AI Visibility enregistrée, enregistrements détaillés, comparaisons et santé du site.

Clés d’API REST

Créez une clé d’API REST dans Paramètres → Applications connectées et authentifiez chaque requête avec un jeton Bearer.

Utilisation du compte

Consultez les limites du forfait, les droits et l’utilisation restante avant de lancer des crawls ou de traiter de nombreux enregistrements.

Gestion des projets

Listez, créez, mettez à jour et supprimez les projets Screpy disponibles pour la clé d’API REST dans votre flux personnalisé.

Flux de crawl

Lisez la liste des crawls d’un projet et utilisez l’UID renvoyé pour connecter les résultats sélectionnés à votre application.

Résumés de crawl

Retournez le statut, les indicateurs de santé, les problèmes, les totaux et la progression pour les rapports et le monitoring SEO technique.

Comparaisons de crawls

Comparez deux crawls terminés lorsque votre produit doit montrer les changements entre deux références SEO techniques.

Enregistrements de pages

Récupérez les pages et leurs détails exacts pour une analyse SEO technique par URL dans une interface personnalisée.

Enregistrements de liens et d’images

Récupérez les liens, images et le contexte de leur page source depuis un crawl terminé sélectionné.

Résultats on-page

Utilisez le contexte d’audit on-page et les données de crawl pour créer une revue technique ciblée des URL importantes.

Quick Wins

Intégrez les opportunités Search Console prioritaires dans un tableau de bord ou une automatisation avec le contexte du projet et de la période.

API Rank Tracker

Lisez la visibilité, l’historique des mots-clés, les résultats enregistrés et les segments, puis ajoutez ou supprimez des mots-clés suivis et gérez les segments par URL.

API AI Visibility

Lisez les données enregistrées de synthèse, mentions, réponses, citations, prompts et sources, puis ajoutez ou supprimez logiquement les prompts suivis selon la limite du forfait.

Données Core Web Vitals

Récupérez les résultats Core Web Vitals disponibles via l’API de santé pour les flux SEO axés sur la performance.

Données de disponibilité

Récupérez le statut de disponibilité et les incidents récents afin d’afficher ces signaux à côté des données SEO techniques.

Questions sur l’API SEO.

Découvrez comment l’API REST Screpy authentifie les requêtes, délimite les projets et crawls et expose les données pour vos produits SEO et automatisations.

Comment créer une clé d’API SEO Screpy ?

Créez une clé d’API REST dans Paramètres → Applications connectées, puis envoyez-la comme jeton Bearer à chaque requête. Les identifiants OAuth MCP n’authentifient pas l’API REST Screpy.

Qui peut utiliser l’API SEO Screpy ?

L’API REST Screpy est disponible pour les comptes membres payants. Chaque requête vérifie l’éligibilité, les droits et l’accès au projet demandé.

Comment trouver un UID de projet et un UID de crawl ?

Commencez par GET /projects pour lister les projets disponibles pour la clé. Utilisez l’UID du projet choisi avec sa liste de crawls, qui renvoie l’UID nécessaire aux requêtes de données.

Quelles données l’API SEO Screpy peut-elle renvoyer ?

Pour un crawl terminé sélectionné, l’API REST peut renvoyer des pages, liens, images, résultats on-page et Quick Wins. Conservez le périmètre du projet et du crawl ensemble pour les rapports et automatisations.

L’API SEO Screpy peut-elle comparer des crawls ?

Oui. L’API de comparaison accepte deux références de crawls terminés et renvoie une comparaison structurée pour étudier les changements entre leurs références.

Puis-je gérer Rank Tracker avec l’API ?

Oui. L’API prend en charge la synthèse Rank Tracker, la gestion des mots-clés, l’historique et les résultats enregistrés ainsi que l’aperçu ou la gestion des segments. Elle ne propose pas d’export CSV/XLSX, de recherche SERP en direct ni de nouvelle analyse manuelle.

Puis-je utiliser AI Visibility avec l’API ?

Oui. L’API lit les données enregistrées de synthèse, mentions, réponses, citations, prompts et sources et peut ajouter ou supprimer logiquement des prompts. Les exports CSV et Excel restent réservés au tableau de bord et les suggestions ou réanalyses manuelles ne sont pas disponibles via l’API.

Puis-je récupérer Core Web Vitals et la disponibilité avec l’API ?

Oui. Core Web Vitals et disponibilité sont exposés par des endpoints de santé distincts, car ce sont des signaux différents. Une réponse data: null peut indiquer qu’aucun contrôle correspondant n’est encore disponible.

Quelle est la différence entre l’API SEO Screpy et SEO MCP ?

L’API SEO Screpy est une API REST pour les produits, tableaux de bord et automatisations personnalisés, authentifiée par une clé REST. Screpy SEO MCP expose des outils Screpy structurés aux assistants IA compatibles via OAuth et le Model Context Protocol.