> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalogue des endpoints

> Retrouvez chaque opération de l’API REST v1 par méthode, chemin et référence : lectures et commandes pour prompts, webhooks et Diagnostic du site.

La référence REST contient **79 opérations : 51 lectures GET et 28 commandes**. Chaque opération ci-dessous a sa propre page de référence. Téléchargez la [spécification OpenAPI](https://docs.qwairy.co/openapi.json) pour générer des clients.

Les lectures démarrent avec Growth et Agency Growth ; certains endpoints peuvent exiger des capacités supplémentaires. Les commandes exigent Business, Agency Business ou Enterprise, et un jeton d’API dont l’accès en écriture est activé. La commande d’estimation utilise POST sans lancer de travail. La gestion des endpoints de webhook, lectures comprises, exige Business, Agency Business ou Enterprise. Consultez [Authentification](https://docs.qwairy.co/fr/developers/authentication.md) et [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md).

| Méthode | Endpoint | Référence |
| - | - | - |
| GET | `/api/v1/brands` | [Lister les marques](https://docs.qwairy.co/fr/developers/endpoints/brands/list.md) |
| GET | `/api/v1/brands/{brandId}` | [Obtenir une marque](https://docs.qwairy.co/fr/developers/endpoints/brands/get.md) |
| POST | `/api/v1/brands` | [Créer un workspace](https://docs.qwairy.co/fr/developers/endpoints/brands/create.md) |
| PATCH | `/api/v1/brands/{brandId}` | [Mettre à jour un workspace](https://docs.qwairy.co/fr/developers/endpoints/brands/update.md) |
| GET | `/api/v1/brands/{brandId}/monitoring` | [Obtenir le suivi](https://docs.qwairy.co/fr/developers/endpoints/brands/monitoring.md) |
| PATCH | `/api/v1/brands/{brandId}/monitoring` | [Mettre à jour le suivi](https://docs.qwairy.co/fr/developers/endpoints/brands/update-monitoring.md) |
| GET | `/api/v1/brands/{brandId}/keywords` | [Lister les Topics](https://docs.qwairy.co/fr/developers/endpoints/keywords/list.md) |
| GET | `/api/v1/brands/{brandId}/keywords/{keywordId}` | [Obtenir un Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/get.md) |
| POST | `/api/v1/brands/{brandId}/keywords` | [Créer un Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/manage.md) |
| PATCH | `/api/v1/brands/{brandId}/keywords/{keywordId}` | [Mettre à jour un Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/update.md) |
| DELETE | `/api/v1/brands/{brandId}/keywords/{keywordId}` | [Supprimer un Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/delete.md) |
| GET | `/api/v1/brands/{brandId}/keywords/{keywordId}/evolution` | [Évolution d’un Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/evolution.md) |
| GET | `/api/v1/brands/{brandId}/tags` | [Lister les Tags](https://docs.qwairy.co/fr/developers/endpoints/tags/list.md) |
| GET | `/api/v1/brands/{brandId}/tags/{tagId}` | [Obtenir un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/get.md) |
| POST | `/api/v1/brands/{brandId}/tags` | [Créer un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/create.md) |
| PATCH | `/api/v1/brands/{brandId}/tags/{tagId}` | [Mettre à jour un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/update.md) |
| DELETE | `/api/v1/brands/{brandId}/tags/{tagId}` | [Supprimer un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/delete.md) |
| GET | `/api/v1/brands/{brandId}/tags/{tagId}/evolution` | [Évolution d’un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/evolution.md) |
| GET | `/api/v1/brands/{brandId}/prompt-suggestions` | [Obtenir les suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/get.md) |
| POST | `/api/v1/brands/{brandId}/prompt-suggestions/runs` | [Générer des suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/generate.md) |
| GET | `/api/v1/brands/{brandId}/prompt-suggestions/runs/{suggestionRunId}` | [Obtenir une génération de suggestions](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/get-run.md) |
| POST | `/api/v1/brands/{brandId}/prompt-suggestions/accept` | [Accepter des suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/accept.md) |
| POST | `/api/v1/brands/{brandId}/runs/estimate` | [Estimer un run](https://docs.qwairy.co/fr/developers/endpoints/runs/estimate.md) |
| POST | `/api/v1/brands/{brandId}/runs` | [Lancer un run](https://docs.qwairy.co/fr/developers/endpoints/runs/manage.md) |
| GET | `/api/v1/brands/{brandId}/runs` | [Lister les runs](https://docs.qwairy.co/fr/developers/endpoints/runs/list.md) |
| GET | `/api/v1/brands/{brandId}/runs/{runId}` | [Obtenir un run](https://docs.qwairy.co/fr/developers/endpoints/runs/get.md) |
| GET | `/api/v1/credits` | [Crédits](https://docs.qwairy.co/fr/developers/endpoints/credits.md) |
| GET | `/api/v1/brands/{brandId}/performance` | [Obtenir l’instantané de performance](https://docs.qwairy.co/fr/developers/endpoints/performance.md) |
| GET | `/api/v1/brands/{brandId}/matrix` | [Obtenir la GEO Matrix](https://docs.qwairy.co/fr/developers/endpoints/matrix.md) |
| GET | `/api/v1/brands/{brandId}/prompts` | [Lister les prompts](https://docs.qwairy.co/fr/developers/endpoints/prompts/list.md) |
| GET | `/api/v1/brands/{brandId}/prompts/{promptId}` | [Obtenir un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/get.md) |
| GET | `/api/v1/brands/{brandId}/prompts/{promptId}/answers` | [Réponses d’un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/answers.md) |
| GET | `/api/v1/brands/{brandId}/prompts/{promptId}/evolution` | [Évolution d’un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/evolution.md) |
| POST | `/api/v1/brands/{brandId}/prompts` | [Créer un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/manage.md) |
| PATCH | `/api/v1/brands/{brandId}/prompts/{promptId}` | [Mettre à jour un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/update.md) |
| POST | `/api/v1/brands/{brandId}/prompts/bulk` | [Mettre à jour des prompts en masse](https://docs.qwairy.co/fr/developers/endpoints/prompts/bulk.md) |
| GET | `/api/v1/brands/{brandId}/answers` | [Lister les réponses](https://docs.qwairy.co/fr/developers/endpoints/answers/list.md) |
| GET | `/api/v1/brands/{brandId}/answers/{answerId}` | [Obtenir une réponse](https://docs.qwairy.co/fr/developers/endpoints/answers/get.md) |
| GET | `/api/v1/brands/{brandId}/competitors` | [Lister les concurrents](https://docs.qwairy.co/fr/developers/endpoints/competitors/list.md) |
| GET | `/api/v1/brands/{brandId}/competitors/{competitorId}` | [Obtenir un concurrent](https://docs.qwairy.co/fr/developers/endpoints/competitors/get.md) |
| GET | `/api/v1/brands/{brandId}/competitors/{competitorId}/evolution` | [Évolution d’un concurrent](https://docs.qwairy.co/fr/developers/endpoints/competitors/evolution.md) |
| GET | `/api/v1/brands/{brandId}/source-domains` | [Lister les domaines sources](https://docs.qwairy.co/fr/developers/endpoints/source-domains/list.md) |
| GET | `/api/v1/brands/{brandId}/source-domains/{sourceId}` | [Obtenir un domaine source](https://docs.qwairy.co/fr/developers/endpoints/source-domains/get.md) |
| GET | `/api/v1/brands/{brandId}/source-domains/{sourceId}/evolution` | [Évolution d’un domaine source](https://docs.qwairy.co/fr/developers/endpoints/source-domains/evolution.md) |
| GET | `/api/v1/brands/{brandId}/source-urls` | [Lister les URL sources](https://docs.qwairy.co/fr/developers/endpoints/source-urls.md) |
| GET | `/api/v1/brands/{brandId}/search` | [Lister les enregistrements Query Fan-Out](https://docs.qwairy.co/fr/developers/endpoints/search.md) |
| GET | `/api/v1/brands/{brandId}/follow-ups` | [Lister les questions de suivi](https://docs.qwairy.co/fr/developers/endpoints/follow-ups.md) |
| GET | `/api/v1/brands/{brandId}/shopping` | [Lister les résultats shopping](https://docs.qwairy.co/fr/developers/endpoints/shopping.md) |
| GET | `/api/v1/brands/{brandId}/local` | [Lister les commerces locaux](https://docs.qwairy.co/fr/developers/endpoints/local.md) |
| GET | `/api/v1/brands/{brandId}/social` | [Lister les signaux sociaux](https://docs.qwairy.co/fr/developers/endpoints/social.md) |
| GET | `/api/v1/brands/{brandId}/sponsored` | [Lister les contenus sponsorisés](https://docs.qwairy.co/fr/developers/endpoints/sponsored.md) |
| GET | `/api/v1/brands/{brandId}/crawler-analytics` | [Obtenir les analytics des crawlers](https://docs.qwairy.co/fr/developers/endpoints/crawler-analytics.md) |
| GET | `/api/v1/brands/{brandId}/perception` | [Lister les instantanés de perception](https://docs.qwairy.co/fr/developers/endpoints/perception/list.md) |
| GET | `/api/v1/brands/{brandId}/perception/{snapshotId}` | [Obtenir un instantané de perception](https://docs.qwairy.co/fr/developers/endpoints/perception/get.md) |
| GET | `/api/v1/brands/{brandId}/actions` | [Lister les actions](https://docs.qwairy.co/fr/developers/endpoints/actions/list.md) |
| PATCH | `/api/v1/brands/{brandId}/actions/{actionId}` | [Mettre à jour le statut d’une action](https://docs.qwairy.co/fr/developers/endpoints/actions/update-status.md) |
| GET | `/api/v1/brands/{brandId}/content` | [Lister les contenus](https://docs.qwairy.co/fr/developers/endpoints/content/list.md) |
| GET | `/api/v1/brands/{brandId}/content/{articleId}` | [Obtenir un contenu](https://docs.qwairy.co/fr/developers/endpoints/content/get.md) |
| GET | `/api/v1/brands/{brandId}/technical-analysis` | [Obtenir l’analyse de préparation du site](https://docs.qwairy.co/fr/developers/endpoints/technical-analysis.md) |
| GET | `/api/v1/brands/{brandId}/site-diagnostics` | [Lister les pages suivies](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/list.md) |
| GET | `/api/v1/brands/{brandId}/site-diagnostics/{pageId}` | [Obtenir une page suivie](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/get.md) |
| POST | `/api/v1/brands/{brandId}/site-diagnostics/pages` | [Ajouter des pages à suivre](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/add-pages.md) |
| POST | `/api/v1/brands/{brandId}/site-diagnostics/audits` | [Lancer un audit de pages](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/start-audit.md) |
| GET | `/api/v1/brands/{brandId}/site-diagnostics/audits/{siteAuditId}` | [Obtenir un audit de pages](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/get-audit.md) |
| POST | `/api/v1/pitch-audits` | [Créer un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/create.md) |
| PATCH | `/api/v1/pitch-audits/{auditId}/prompts` | [Enregistrer les prompts d’un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/save-prompts.md) |
| POST | `/api/v1/pitch-audits/{auditId}/confirm` | [Confirmer un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/confirm.md) |
| GET | `/api/v1/pitch-audits` | [Lister les audits de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/list.md) |
| GET | `/api/v1/pitch-audits/{auditId}` | [Obtenir un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/get.md) |
| GET | `/api/v1/pitch-audits/{auditId}/reports/{subjectId}` | [Obtenir le rapport d’un sujet d’audit](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/get-report.md) |
| GET | `/api/v1/webhooks` | [Lister les endpoints de webhook](https://docs.qwairy.co/fr/developers/endpoints/webhooks/list.md) |
| POST | `/api/v1/webhooks` | [Créer un endpoint de webhook](https://docs.qwairy.co/fr/developers/endpoints/webhooks/create.md) |
| GET | `/api/v1/webhooks/{webhookId}` | [Obtenir un endpoint de webhook](https://docs.qwairy.co/fr/developers/endpoints/webhooks/get.md) |
| PATCH | `/api/v1/webhooks/{webhookId}` | [Mettre à jour un endpoint de webhook](https://docs.qwairy.co/fr/developers/endpoints/webhooks/update.md) |
| DELETE | `/api/v1/webhooks/{webhookId}` | [Supprimer un endpoint de webhook](https://docs.qwairy.co/fr/developers/endpoints/webhooks/delete.md) |
| POST | `/api/v1/webhooks/{webhookId}/rotate-secret` | [Renouveler le secret de signature](https://docs.qwairy.co/fr/developers/endpoints/webhooks/rotate-secret.md) |
| POST | `/api/v1/webhooks/{webhookId}/test` | [Envoyer un événement de test](https://docs.qwairy.co/fr/developers/endpoints/webhooks/test.md) |
| GET | `/api/v1/webhooks/{webhookId}/deliveries` | [Lister les envois](https://docs.qwairy.co/fr/developers/endpoints/webhooks/deliveries.md) |
| POST | `/api/v1/webhooks/{webhookId}/deliveries/{deliveryId}/redeliver` | [Renvoyer un événement](https://docs.qwairy.co/fr/developers/endpoints/webhooks/redeliver.md) |

## Interfaces liées

Les [webhooks d’intégration](https://docs.qwairy.co/fr/developers/integration-webhooks/overview.md) envoient des événements de fin signés vers votre endpoint HTTPS. Vous gérez leurs endpoints avec les opérations de webhook ci-dessus.
Les [webhooks sortants](https://docs.qwairy.co/fr/developers/webhooks.md) sont des notifications distinctes, configurées dans le tableau de bord, pour les équipes en marque blanche ; ce ne sont pas des endpoints de l’API REST v1.
Les [connecteurs d’ingestion de crawlers](https://docs.qwairy.co/fr/documentation/measure/crawler-analytics/connectors/generic-http.md) ont leurs propres contrats d’authentification et de livraison.
Les chemins non définis renvoient 404 et ne sont pas des opérations de ce catalogue.

L’appartenance à l’équipe, les rôles, les invitations, les transferts de crédits, les recharges et la gestion publique des clés d’API restent en dehors de cette surface REST.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.