API SEO

Créez vos rapports SEO et automatisations avec le JSON structuré de vos projets Screpy. Récupérez les constats de crawl, positions de mots-clés, backlinks, données AI Visibility enregistrées et résultats de suivi via une API REST par projet, avec des actions prises en charge pour gérer votre travail.

Lire le guide de démarrage de l’API Créer un compte Screpy

Lister les projets accessibles

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Extrait de réponse illustratif. L'accès REST nécessite un compte membre payant ; la clé renvoie uniquement vos projets ou les projets partagés auxquels vous avez accès.

Authentifier la SEO API

Créez une clé REST dans Paramètres → Applications connectées, puis envoyez-la comme jeton bearer depuis votre serveur. Choisissez les permissions nécessaires à votre intégration.

Les clés en lecture seule récupèrent des données ; les clés de lecture et écriture permettent aussi les modifications prises en charge.
Copiez le secret à sa création : il n'est affiché qu'une fois. Ne l'exposez pas dans du code navigateur public.
Révoquez les clés dans Applications connectées. Vous pouvez avoir jusqu'à 20 clés actives ; elles expirent après un an.

Lire le guide d'authentification

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

Vérifier l'accès API

REST nécessite un compte membre payant. L'appartenance au projet et les fonctions auxquelles celui-ci a droit déterminent aussi les données et actions disponibles.

Les endpoints de compte exposent votre offre, les fonctions et le nombre de projets accessibles.
Les rapports d'utilisation indiquent les limites par fonction, mais les quantités utilisées et restantes ne sont calculées que pour vos propres projets actuellement.
Une utilisation null signifie une valeur indisponible, pas une consommation nulle.

Voir les endpoints de compte

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

Gérer les projets SEO

Listez vos projets et ceux partagés, consultez un aperçu ou créez des projets dans votre quota de projets détenus. Utilisez les UID renvoyés pour les requêtes suivantes.

Modifiez les noms, préférences de marché et fuseau horaire, ainsi que les paramètres de crawl ou suivi pris en charge.
Changer de domaine nécessite un nouveau projet ; modifier les paramètres ne réécrit pas les résultats terminés.
La création vérifie la capacité et valide le site.
Seul le propriétaire peut supprimer le projet.

Voir les endpoints de projets

example.comProjet

example.orgProjet

example.netProjet

Lancer des crawls web

Lancez un crawl avec le droit d'écriture et conservez son UID. Il s'exécute en arrière-plan : suivez son statut avant de récupérer les résultats.

Un crawl déjà en cours ou un crawler désactivé peut empêcher un nouveau lancement.
Les résumés et jeux de données exigent un crawl terminé avec succès ; les résultats inachevés renvoient un conflit.
Gardez ensemble les références du projet et du crawl pour vos rapports ou comparaisons d'instantanés.

Voir les endpoints de crawl

1
Examen/guides
Ouvert
2
Généré/shop
Ouvert
Terminéexample.com
En attente

Récupérer les données de crawl SEO

Créez des rapports de SEO technique à partir d'un crawl terminé sélectionné. Consultez les détails des pages et retrouvez les pages sources des liens ou images.

Les pages comprennent statut HTTP, titres, descriptions, en-têtes, canonicals, profondeur de crawl et temps mesurés.
Les liens exposent destinations, textes d'ancrage, statut nofollow et contexte de page source.
Les images comprennent texte alternatif, dimensions, statut de récupération et pages sources.
Utilisez les filtres de champs pris en charge et les données paginées ; il ne s'agit ni d'un export HTML intégral ni d'une interface SQL.

Voir les endpoints de données de crawl

/guides/seo200

Indexé

Comparer projets et crawls

Comparez les résumés de SEO technique entre projets ou entre instantanés de crawls terminés. Conservez des références explicites pour reproduire les comparaisons.

Les comparaisons acceptent deux à cinq projets accessibles, avec les derniers crawls terminés ou des instantanés choisis.
Comparer deux crawls renvoie les variations de santé, pages et problèmes : deuxième valeur moins première.
Ces comparaisons portent sur des résumés ; récupérez les données de crawl séparément pour examiner chaque URL.

Voir les endpoints de comparaison

Avant62→Après87

Récupérer les SEO Quick Wins

Intégrez des opportunités priorisées avec leur source et période de rapport. Une référence de crawl terminé vérifie l'accès sans transformer chaque opportunité en instantané de ce crawl.

Quand les données connectées existent, Search Console fournit des opportunités sur les requêtes proches des premières positions, CTR, cannibalisation, baisses et variations de visibilité.
Les constats de liens internes peuvent utiliser le dernier crawl du projet indiqué dans les métadonnées.
Les constats liés au trafic nécessitent la connexion concernée, les permissions et suffisamment de données.
Conservez types de rapport, dates, avertissements et disponibilité ; un rapport vide ne prouve pas l'absence de problèmes.

Découvrir Quick Wins

linen shirt#11

Impressions

2 860

Gérer le suivi des positions

Consultez la visibilité des mots-clés, l'historique d'analyse et les résultats enregistrés avec leur marché et appareil. Gérez les mots-clés suivis plutôt que demander des recherches arbitraires en direct.

Filtrez par recherche, appareil et segment fondé sur les URL, y compris les mots-clés sans correspondance.
Ajoutez jusqu'à 100 mots-clés par requête ; l'analyse initiale est mise en attente, sans résultat immédiat.
Supprimez des mots-clés suivis et prévisualisez, créez, modifiez ou supprimez des segments avec le droit d'écriture.
REST ne fournit ni SERP en direct, ni réanalyse manuelle, ni export CSV/XLSX de Rank Tracker.

Voir les endpoints de Rank Tracker

Classements

+24 Position

Accéder à AI Visibility

Reliez les réponses IA enregistrées aux mentions de marque, citations et sources. Conservez le contexte de prompt, pays, langue et plateforme dans vos propres rapports.

Consultez aperçus, mentions, réponses, citations, prompts suivis et activité des domaines ou URL sources.
Ajoutez jusqu'à 20 prompts par requête dans la capacité du projet, ou retirez des prompts suivis avec le droit d'écriture.
Suggestions de prompts, réanalyse manuelle et exports AI Visibility ne sont pas des opérations REST.

Découvrir AI Visibility

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Analyser les backlinks

Consultez le profil de backlinks d'un projet ou d'un concurrent déjà ajouté, choisi parmi les options disponibles. Reliez les liens à leurs domaines référents pour vos rapports d'autorité.

Récupérez métriques d'aperçu, domaines référents et backlinks d'un domaine sélectionné.
Examinez les écarts de backlinks et les jeux de données pris en charge sur les domaines perdus ou aux liens cassés.
Conservez cible, filtres, tri et curseur ; ce n'est pas une recherche illimitée pour n'importe quel domaine.
Les exports CSV/XLSX de tableaux couvrent la page actuelle. Continuez avec X-Next-Cursor.

Découvrir Backlink Checker

example.org
example.net
example.edu

example.com84 Liens

Gérer les entrées disavow

Conservez dans le projet des domaines ou URL examinés et leurs notes, puis préparez un fichier texte au format Google. Les décisions de désaveu vous appartiennent.

Le droit d'écriture permet d'ajouter jusqu'à 100 entrées par requête ou de supprimer des entrées existantes.
Exportez le texte disavow du projet séparément des tableaux paginés.
Examinez et soumettez le fichier manuellement ; enregistrer une entrée ne l'envoie pas à Google et ne supprime aucun backlink.

Découvrir Disavow Management

disavow.txtExamen

domain:example.org
https://example.net/links

Domaineexample.org
URLexample.net/links

Consulter la santé du site

Séparez performance des pages et disponibilité du site dans vos rapports. Ces endpoints renvoient des contrôles existants, pas une nouvelle mesure à la demande.

La performance renvoie la dernière page d'accueil contrôlée avec FCP, LCP, CLS, TTFB, TBT et Speed Index, pas toutes les pages ni un historique complet.
Uptime résume les 30 derniers jours et renvoie jusqu'aux 160 contrôles les plus récents avec statut, temps de réponse et date.
Sans performance, la réponse est data:null ; sans contrôles uptime, le résumé garde des valeurs null et la liste reste vide.

Voir les endpoints de santé

example.comLaboratoire

LCP2,1 s
TBT180 ms
CLS0,04

Paginer les données SEO

Récupérez les grands jeux de données par pages gérables et conservez le contexte de requête dans votre traitement. Vérifiez la disponibilité avant de produire une métrique de tableau de bord.

Les listes prises en charge renvoient 50 entrées par défaut et jusqu'à 100 ; suivez les liens suivants ou curseurs opaques.
Gardez filtres, cibles et périodes identiques entre pages. Les paramètres invalides sont rejetés.
Traitez explicitement les erreurs d'autorisation, de crawl inachevé, de données indisponibles ou de débit, plutôt que remplacer les résultats absents par zéro.

Lire le guide des erreurs API

JSONcursor_2

Parlez de API SEO. Avec SEO MCP.

Connectez votre assistant au projet Screpy via SEO MCP. Choisissez un projet, consultez son aperçu et explorez les données prises en charge de crawl, de classement et de recherche avec un accès limité au périmètre autorisé.

Découvrir Screpy SEO MCP Connecter votre assistant IA

Questions sur la SEO API

Des réponses pratiques pour choisir l'accès REST, traiter les données et créer une intégration fiable.

Quelles limites de débit s'appliquent ?

Par minute, la limite de base est de 300 requêtes par clé et 900 par compte. Les endpoints lourds autorisent en plus 60 par clé et 180 par compte ; ceux d'écriture, 30 et 90. Ces contrôles s'appliquent ensemble. Traitez HTTP 429 et réessayez après l'attente autorisée.

Comment trouver les UID du projet et du crawl ?

Appelez GET /projects, choisissez un projet accessible, puis récupérez sa liste de crawls. Utilisez ensemble les UID renvoyés. Les endpoints de résumés et données exigent un crawl terminé avec succès.

Tous les résultats API sont-ils actuels ou en direct ?

Non. Les données de crawl appartiennent à l'instantané choisi ; positions et AI Visibility utilisent des analyses enregistrées. Quick Wins suit sa source et sa période. Les endpoints de santé renvoient des contrôles existants. Conservez dates disponibles et contexte source dans vos rapports.

L'absence de données signifie-t-elle l'absence de problèmes SEO ?

Non. Valeurs null, listes vides, avertissements et erreurs de disponibilité ont des sens différents. Un contrôle de performance absent n'est pas une panne du site, et une utilisation indisponible n'est pas une consommation nulle. Vérifiez réponse et configuration avant de conclure.

Quelle différence entre SEO API et SEO MCP ?

SEO API sert à vos logiciels via des requêtes REST et une clé bearer REST. SEO MCP propose des outils pris en charge aux assistants IA compatibles via Model Context Protocol et sa propre autorisation. Les identifiants MCP n'authentifient pas REST et les opérations disponibles ne sont pas identiques.

Puis-je exporter les données API en CSV ou Excel ?

Les endpoints de tableaux de backlinks permettent le CSV/XLSX de la page actuelle, avec X-Next-Cursor pour continuer. Le texte disavow a son propre export. Les exports CSV/XLSX de Rank Tracker et AI Visibility restent réservés au tableau de bord ; les autres réponses structurées peuvent alimenter votre code de rapports.

REST expose-t-il toutes les fonctions du tableau de bord ?

Non. La référence API liste les opérations REST prises en charge. Il n'existe pas d'endpoints REST pour les résultats Map Tracker, la génération d'articles, les rapports PDF ou toutes les données analytiques brutes. Rank Tracker et AI Visibility ont aussi les limites d'actions et d'export indiquées ci-dessus.

Une clé en lecture seule fonctionne-t-elle avec chaque requête POST ?

Non. Les comparaisons POST de projets et crawls acceptent la lecture car elles analysent des données existantes. Créer ou modifier des données, lancer des crawls et prévisualiser des segments exige lecture et écriture. Vérifiez les permissions documentées plutôt que les déduire de la méthode HTTP.