> ## 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.

# Obtenir un audit de prospection

> Lisez le rapport du prospect d’origine d’un audit de prospection.

Renvoie le rapport d’audit de prospection du prospect d’origine, en lecture seule : profil, prompts, scores, concurrents, sources, insights, recommandations et co-concurrents.

<ParamField header="Authorization" type="string" required>
  Jeton d’API bearer. Exemple : `Bearer qw-api-xxx`
</ParamField>

## Paramètres de chemin

<ParamField path="auditId" type="string" required>
  Identifiant d’audit renvoyé par [Lister les audits de prospection](/fr/developers/endpoints/pitch-audits/list).
</ParamField>

## Paramètres de requête

<ParamField query="includeAnswers" type="boolean" default="false">
  Inclut le texte complet des réponses IA. Gardez la valeur par défaut pour un rapport de taille limitée ; demandez les réponses explicitement lorsqu’une analyse au niveau des preuves est nécessaire.
</ParamField>

<ParamField query="includeCoCompetitorScores" type="boolean" default="false">
  Ajoute la synthèse `scores` complète à chaque ligne de `coCompetitors`. Utilisez cette extension pour comparer tous les co-concurrents en une seule requête.
</ParamField>

## Réponse

<ResponseField name="success" type="boolean">
  `true` lorsque le rapport a été renvoyé.
</ResponseField>

<ResponseField name="team" type="object">
  Identifiant et nom du workspace agence.
</ResponseField>

<ResponseField name="audit" type="object">
  <Expandable title="Rapport d’audit de prospection">
    <ResponseField name="reportSubject" type="object">Le prospect d’origine ou le concurrent représenté par ce rapport.</ResponseField>
    <ResponseField name="availableSubjects" type="array">Tous les sujets qui peuvent être demandés via `subjectId`.</ResponseField>
    <ResponseField name="summary" type="object">Scores, fournisseurs, classement des concurrents, sources, insights, préparation technique, affirmations et recommandations.</ResponseField>
    <ResponseField name="answersIncluded" type="boolean">Indique si les réponses complètes ont été demandées.</ResponseField>
    <ResponseField name="coCompetitorScoresIncluded" type="boolean">Indique si chaque ligne de co-concurrent inclut sa synthèse de scores complète.</ResponseField>
    <ResponseField name="answerCount" type="number">Nombre de réponses disponibles dans le rapport.</ResponseField>
    <ResponseField name="answers" type="array">Réponses IA complètes. Présent uniquement avec `includeAnswers=true`.</ResponseField>
    <ResponseField name="coCompetitors" type="array">Marques présentes dans les mêmes réponses que le sujet actuel. Chaque ligne inclut un `subjectId` résoluble, un `reportUrl`, des indicateurs de co-occurrence et, en option, `scores`.</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête pour le prospect d’origine

```bash theme={null}
curl "https://www.qwairy.co/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

## Suivre le lien d’un co-concurrent

Prenez `subjectId` et le `reportUrl` canonique directement dans une ligne de `coCompetitors` :

```json theme={null}
{
  "id": "orbit.example",
  "subjectId": "orbit.example",
  "name": "Orbit Systems",
  "sharedAnswers": 12,
  "subjectAvgPosition": 2.1,
  "competitorAvgPosition": 1.7,
  "sharedSourcesCount": 9,
  "reportUrl": "/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8/reports/orbit.example"
}
```

Suivez `reportUrl`, ou consultez [Obtenir le rapport d’un sujet](/fr/developers/endpoints/pitch-audits/get-report). Un co-concurrent est une vue dérivée du même audit, pas un audit distinct.

## Inclure les scores de tous les co-concurrents

```bash theme={null}
curl "https://www.qwairy.co/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8?includeCoCompetitorScores=true" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

Lisez `audit.coCompetitors`. Chaque ligne inclut les indicateurs de relation ainsi que `scores.geoScore`, `scores.mentionRate`, `scores.avgPosition`, `scores.sentimentScore`, `scores.shareOfVoice` et les indicateurs de citation. N’utilisez `subjectId` que si vous avez besoin du rapport dérivé complet.

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 400 | `INVALID_PARAMETER` | Paramètre de requête invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | `PITCH_AUDIT_NOT_FOUND` | Audit ou sujet demandé inaccessible |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez `Retry-After` |


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