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

# Lister les signaux sociaux

> Listez les citations classées comme sources de plateformes sociales dans les réponses enregistrées.

Renvoie les citations classées comme sources sociales ou de forums dans les réponses enregistrées. Les valeurs de filtre stables sont `reddit`, `youtube`, `twitter`, `facebook`, `linkedin` et `other`.

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

```http theme={null}
GET /api/v1/brands/{brandId}/social
```

## Paramètres de chemin

<ParamField path="brandId" type="string" required>
  L’identifiant unique de la marque
</ParamField>

## Paramètres de requête

<ParamField query="period" type="number">
  Nombre de jours à inclure. Sans valeur, toutes les données sont renvoyées.
</ParamField>

<ParamField query="startDate" type="string">
  Date de début au format `YYYY-MM-DD`. Fournissez-la avec `endDate` ; une borne seule est actuellement ignorée. Choisissez soit `period`, soit la paire de dates complète.
</ParamField>

<ParamField query="endDate" type="string">
  Date de fin au format `YYYY-MM-DD`. Fournissez-la avec `startDate` ; une borne seule est actuellement ignorée. Ne combinez pas la paire de dates complète avec `period`.
</ParamField>

<ParamField query="provider" type="string">
  Filtre par un ou plusieurs alias de fournisseurs ou identifiants de modèles, séparés par des virgules.
</ParamField>

<ParamField query="platform" type="string">
  Filtre par plateforme : `reddit`, `youtube`, `twitter`, `facebook`, `linkedin`, `other`
</ParamField>

<ParamField query="limit" type="number" default="50">
  Nombre maximal de citations renvoyées (maximum : 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Nombre de résultats à ignorer pour la pagination
</ParamField>

<ParamField query="sort" type="string" default="createdAt">
  Champ de tri : `createdAt`, `position`, `upvotes`, `comments`, `url`
</ParamField>

<ParamField query="order" type="string" default="desc">
  Ordre de tri : `asc` ou `desc`
</ParamField>

## Réponse

<ResponseField name="success" type="boolean">
  Indique si la requête a réussi
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Informations de pagination">
    <ResponseField name="total" type="number">Nombre total de citations correspondant aux filtres</ResponseField>
    <ResponseField name="count" type="number">Nombre de citations dans cette réponse</ResponseField>
    <ResponseField name="limit" type="number">Nombre maximal d’éléments par page</ResponseField>
    <ResponseField name="offset" type="number">Nombre d’éléments ignorés</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="social" type="array">
  <Expandable title="Objet citation sociale">
    <ResponseField name="id" type="string">Identifiant de l’observation sociale</ResponseField>
    <ResponseField name="platform" type="string">Nom de la plateforme (reddit, youtube, twitter, etc.)</ResponseField>
    <ResponseField name="communityId" type="string">Identifiant de la communauté (subreddit, chaîne, etc.)</ResponseField>
    <ResponseField name="communityName" type="string">Nom affiché de la communauté</ResponseField>
    <ResponseField name="url" type="string">URL complète du contenu cité</ResponseField>
    <ResponseField name="title" type="string">Titre du contenu (s’il est disponible)</ResponseField>
    <ResponseField name="domain" type="string">Nom de domaine</ResponseField>
    <ResponseField name="position" type="number">Position dans la liste des sources</ResponseField>
    <ResponseField name="upvotes" type="number">Votes positifs ou mentions j’aime (Reddit, si disponible)</ResponseField>
    <ResponseField name="commentCount" type="number">Nombre de commentaires (si disponible)</ResponseField>
    <ResponseField name="createdAt" type="string">Horodatage ISO 8601</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/social?platform=reddit&limit=10" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 156,
    "count": 2,
    "limit": 10,
    "offset": 0
  },
  "social": [
    {
      "id": "soc1",
      "platform": "reddit",
      "communityId": "SaaS",
      "communityName": "r/SaaS",
      "url": "https://reddit.com/r/SaaS/comments/abc123/best_crm_tools",
      "title": "Analytics tools discussed by a sample community",
      "domain": "reddit.com",
      "position": 2,
      "upvotes": 245,
      "commentCount": 89,
      "createdAt": "2026-07-15T10:30:00Z"
    },
    {
      "id": "soc2",
      "platform": "youtube",
      "communityId": "TechReviewer",
      "communityName": "TechReviewer",
      "url": "https://youtube.com/@TechReviewer/crm-comparison",
      "title": "Synthetic analytics comparison",
      "domain": "youtube.com",
      "position": 3,
      "upvotes": 0,
      "commentCount": 0,
      "createdAt": "2026-07-14T15:45:00Z"
    }
  ]
}
```

<Note>
  Les métadonnées d’engagement manquantes sont renvoyées à `0`. N’interprétez pas `0` comme un engagement vérifié sur la plateforme sans consulter la source.
</Note>

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 400 | `INVALID_PARAMETER` | Valeur de filtre, de pagination ou de tri invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | `BRAND_NOT_FOUND` | Marque inexistante ou 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.