Searvia
Centre d’aide · IA, API et MCP

Utiliser l'API REST Searvia

Lisez classements, visibilité IA, santé du site, avis et données de marché depuis vos propres scripts et tableaux de bord, avec les mêmes clés et limites que MCP.

Environ 4 minutes

Ce dont vous avez besoin

  • Une clé API depuis Paramètres › API et MCP
  • Tous les forfaits : Free inclut 100 appels API et MCP par mois, Indie 1 000, Starter et supérieurs en illimité
  1. 1

    Créer une clé

    Compte › API & MCP

    Créez une clé pour le script ou le serveur qui appellera l'API. Elle ne fonctionne que dans le compte où vous la créez.

  2. 2

    Envoyez-la comme jeton Bearer

    Appelez https://searvia.com/api/v1 avec l'en-tête Authorization: Bearer suivi de votre clé. Commencez par GET /projects pour voir les identifiants de vos projets.

  3. 3

    Choisissez les endpoints dans la référence

    La page développeur liste tous les endpoints ; le fichier OpenAPI sur /api/v1/openapi.json contient tous les champs et fonctionne avec Postman, Insomnia et les générateurs de code.

  4. 4

    Gérez pages, limites et erreurs

    Les listes acceptent page et per_page. Surveillez X-RateLimit-Remaining ; en cas de 429, attendez Retry-After. Les erreurs arrivent toujours sous la forme error.status, error.code et error.message.

Ce que vous obtenez

Vos données alimentent vos propres outils sans copier depuis le panneau.

  • Les appels qui consomment des crédits s'exécutent sans aperçu et renvoient 402 si le solde est trop bas. Chaque modification faite avec une clé apparaît dans le journal d'audit avec le nom de la clé.
  • Pour des lignes quotidiennes à plat (un mot-clé par jour, une réponse IA, un audit), utilisez les endpoints de rapport sous /projects/{id}/reports.

Dépannage et questions

Est-ce la même chose que MCP ?
Oui. Chaque endpoint exécute le même outil que le serveur MCP, donc résultats, limites du forfait et crédits sont identiques. MCP est pensé pour les assistants IA ; l'API REST pour le code.
Une connexion en lecture seule peut-elle modifier des données ?
Non. Les applications connectées en lecture seule reçoivent 403 sur les endpoints qui modifient ou dépensent.

Aussi via MCP :list_projectsget_keyword_rankings

Ouvrir la référence de l'API