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.
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.
/projectsJSONAuthorization: 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.
/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.
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.
- 1ExamenOuvert
/guides - 2GénéréOuvert
/shop - TerminéEn attente
example.com
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.
/guides/seo200
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.
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.
linen shirt#11
Impressions
2 860Gé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.
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.
example.com [1]
example.org [2]
example.org/guidesexample.net/researchAnalyser 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.
- example.org
- example.net
- example.edu
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.
disavow.txtExamendomain: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.
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.
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é.
- Screpy: Bonjour ! Regardons API SEO pour example.com. Que souhaitez-vous savoir ?
- Vous: Liste mes projets Screpy et ouvre l’aperçu d’example.com.
- Screpy: Choisissez example.com et examinez le dernier crawl terminé ainsi que les données disponibles. L’assistant n’accède qu’aux projets accessibles à votre compte Screpy. Contexte du projet: Projet: example.com. Crawl: Dernière exécution terminée.
- Vous: Transforme cela en un court plan d’action.
- Screpy: Je séparerai les constats des recommandations. Examinez les preuves, choisissez une modification puis vérifiez les résultats. Vos prochaines étapes: Examiner: Vérifier la source et la date de chaque constat.. Décider: Choisir la première modification.. Vérifier: Comparer les résultats après la modification..
- Vous: Peux-tu expliquer les preuves simplement ?
- Screpy: Oui. Interrogez-moi sur un résultat pris en charge pour comprendre ce qu’il montre, sa source et les incertitudes. Les données manquantes restent indisponibles ; les recommandations ne sont pas des corrections automatiques.
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.
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 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.
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.
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.
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.
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.
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.
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.