Lister les actions

curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/actions?status=SUGGESTED&limit=10" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"

{
  "data": [
    {
      "id": "action_01",
      "type": "SOURCE_OUTREACH",
      "category": "AUTHORITY",
      "sourceType": "SOURCE_OPPORTUNITY",
      "scope": "OFF_SITE",
      "title": "Review citation gap for Publisher Example",
      "description": "Stored answers cite this source 16 times without a SELF mention.",
      "sourceUrl": "https://publisher.example",
      "targetProvider": null,
      "evidenceProviders": ["example-provider"],
      "evidenceScope": "OBSERVED",
      "forceTier": "HIGH",
      "priorityScore": 53,
      "demandBadge": 3,
      "isQuickWin": false,
      "effort": "MEDIUM",
      "status": "SUGGESTED",
      "signals": {
        "citations": 16,
        "sourceCategory": "MEDIA",
        "competitivePressure": 2
      },
      "impactJustification": "Source cited 16x by AI answers without mentioning the brand.",
      "effortJustification": "Outreach: research the contact, pitch, and follow up.",
      "baselineMetric": null,
      "targetMetric": null,
      "questionId": null,
      "checklist": [
        "Review what content the source already cites",
        "Compare the cited pages with your existing evidence",
        "Decide whether an outreach hypothesis is worth testing",
        "Record the test and monitor later observations"
      ],
      "createdAt": "2026-06-12T05:00:00.000Z",
      "updatedAt": "2026-06-12T05:00:00.000Z"
    }
  ],
  "pagination": { "total": 42, "limit": 10, "offset": 0, "hasMore": true }
}

GET

https://www.qwairy.co

api

brands

{brandId}

actions

curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/actions?status=SUGGESTED&limit=10" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"

{
  "data": [
    {
      "id": "action_01",
      "type": "SOURCE_OUTREACH",
      "category": "AUTHORITY",
      "sourceType": "SOURCE_OPPORTUNITY",
      "scope": "OFF_SITE",
      "title": "Review citation gap for Publisher Example",
      "description": "Stored answers cite this source 16 times without a SELF mention.",
      "sourceUrl": "https://publisher.example",
      "targetProvider": null,
      "evidenceProviders": ["example-provider"],
      "evidenceScope": "OBSERVED",
      "forceTier": "HIGH",
      "priorityScore": 53,
      "demandBadge": 3,
      "isQuickWin": false,
      "effort": "MEDIUM",
      "status": "SUGGESTED",
      "signals": {
        "citations": 16,
        "sourceCategory": "MEDIA",
        "competitivePressure": 2
      },
      "impactJustification": "Source cited 16x by AI answers without mentioning the brand.",
      "effortJustification": "Outreach: research the contact, pitch, and follow up.",
      "baselineMetric": null,
      "targetMetric": null,
      "questionId": null,
      "checklist": [
        "Review what content the source already cites",
        "Compare the cited pages with your existing evidence",
        "Decide whether an outreach hypothesis is worth testing",
        "Record the test and monitor later observations"
      ],
      "createdAt": "2026-06-12T05:00:00.000Z",
      "updatedAt": "2026-06-12T05:00:00.000Z"
    }
  ],
  "pagination": { "total": 42, "limit": 10, "offset": 0, "hasMore": true }
}

Renvoie la file actuelle du Centre d’actions d’une marque. Les scores, paliers et indicateurs de gain rapide sont des résultats déterministes des règles de notation actuelles du Centre d’actions ; considérez-les comme des aides à la priorisation, pas comme des résultats prédits.

string

requis

Jeton bearer. Exemple : Bearer qw-api-xxx

Paramètres de chemin

string

requis

L’identifiant unique de la marque

Paramètres de requête

string

Filtre par statut : SUGGESTED (en attente de tri), PENDING, IN_PROGRESS, COMPLETED, DISMISSED, RESOLVED (signal disparu, fermeture automatique). Par défaut, la file active : SUGGESTED + PENDING + IN_PROGRESS.

string

Filtre par type d’action : CONTENT_GAP, CONTENT_OPTIMIZE, TECHNICAL_FIX, SCHEMA_ADD, AUTHORITY_BUILD, SOURCE_OUTREACH, COMPETITOR_ANALYSIS, PERCEPTION_FIX, SEARCH_TARGET, SOCIAL_ENGAGE, PRODUCT_OPTIMIZE, LOCAL_OPTIMIZE

string

Filtre par catégorie : TECHNICAL, CONTENT, AEO, AUTHORITY, VISIBILITY

string

Filtre selon les fournisseurs à l’origine des données observées. Accepte des identifiants de fournisseurs répétés ou séparés par des virgules.

string

Filtre par identifiants de Topics. Accepte des UUID répétés ou séparés par des virgules.

string

Filtre par identifiants de Tags. Accepte des UUID répétés ou séparés par des virgules.

string

défaut:"or"

Combine les Tags sélectionnés par or ou and.

string

Filtre par TOFU, MOFU, BOFU ou POST_PURCHASE. Accepte des valeurs répétées ou séparées par des virgules.

string

défaut:"all"

Période des données : 1, 7, 14, 30, 90, all ou custom.

string

Date de début au format YYYY-MM-DD. Obligatoire avec periodEnd lorsque period=custom.

string

Date de fin au format YYYY-MM-DD. Obligatoire avec periodStart lorsque period=custom.

number

défaut:"50"

Nombre maximal d’actions renvoyées (maximum : 100)

number

défaut:"0"

Décalage de pagination

Réponse

array

Actions triées par priorité (la plus haute d’abord), puis par date de création.

Afficher Objet action

string

Identifiant unique de l’action

string

Type d’action (voir le filtre type pour les valeurs)

string

Catégorie de l’action

string

Famille de détecteur à l’origine de l’action (par exemple PAGE_ISSUE, QUESTION_GAP, SOURCE_OPPORTUNITY, SEARCH_QUERY)

string

Nature du travail : ON_SITE, OFF_SITE ou SETUP

string

Titre de l’action

string

Quoi faire et pourquoi

string | null

URL externe à l’appui de l’action, le cas échéant

string | null

Fournisseur IA ciblé par cette action (null = niveau de la marque)

array

Identifiants des fournisseurs explicitement présents dans les données sous-jacentes

string

OBSERVED, CURRENT ou UNATTRIBUTED

string

Palier de priorité : CRITICAL, HIGH ou STANDARD

number

Score de 0 à 100 ancré sur le palier : Critical de 70 à 100, High de 40 à 69 et Standard de 10 à 39. Il est calculé à partir du palier, du badge de demande, de l’effort et du périmètre de fournisseurs.

number

Signal de demande de 1 à 5

boolean

Indique si l’heuristique du Centre d’actions classe l’élément comme gain rapide

string

Charge estimée : LOW, MEDIUM ou HIGH

string

Statut dans le cycle de vie

object | null

Signaux chiffrés bruts à l’origine de la priorité (citations, occurrences de Query Fan-Out, impressions, pression concurrentielle, pages concernées…)

string | null

Explication enregistrée des signaux utilisés pour la priorisation

string | null

Explication de l’effort estimé

number | null

Valeur de l’indicateur enregistrée à la création de l’action

number | null

Valeur cible de l’indicateur, le cas échéant

string | null

Prompt suivi lié, le cas échéant

array

Checklist générée associée à l’action

string

Date de création ISO 8601

string

Date de dernière mise à jour ISO 8601

object

total, limit, offset, hasMore

Exemple de requête

curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/actions?status=SUGGESTED&limit=10" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"

Exemple de réponse

{
  "data": [
    {
      "id": "action_01",
      "type": "SOURCE_OUTREACH",
      "category": "AUTHORITY",
      "sourceType": "SOURCE_OPPORTUNITY",
      "scope": "OFF_SITE",
      "title": "Review citation gap for Publisher Example",
      "description": "Stored answers cite this source 16 times without a SELF mention.",
      "sourceUrl": "https://publisher.example",
      "targetProvider": null,
      "evidenceProviders": ["example-provider"],
      "evidenceScope": "OBSERVED",
      "forceTier": "HIGH",
      "priorityScore": 53,
      "demandBadge": 3,
      "isQuickWin": false,
      "effort": "MEDIUM",
      "status": "SUGGESTED",
      "signals": {
        "citations": 16,
        "sourceCategory": "MEDIA",
        "competitivePressure": 2
      },
      "impactJustification": "Source cited 16x by AI answers without mentioning the brand.",
      "effortJustification": "Outreach: research the contact, pitch, and follow up.",
      "baselineMetric": null,
      "targetMetric": null,
      "questionId": null,
      "checklist": [
        "Review what content the source already cites",
        "Compare the cited pages with your existing evidence",
        "Decide whether an outreach hypothesis is worth testing",
        "Record the test and monitor later observations"
      ],
      "createdAt": "2026-06-12T05:00:00.000Z",
      "updatedAt": "2026-06-12T05:00:00.000Z"
    }
  ],
  "pagination": { "total": 42, "limit": 10, "offset": 0, "hasMore": true }
}

Erreurs

Statut	Signification
`400`	Filtre d’énumération, de taxonomie, de fournisseur ou de période invalide
`401`	Jeton d’API manquant ou invalide
`404`	Marque introuvable ou inaccessible
`429`	Limite de débit dépassée ; respectez `Retry-After`

Consultez Limites de débit pour la gestion des nouvelles tentatives.

Bien démarrer

Configurer les données

Suivi et mesure

Analyse et action

Agence et automatisation

Guides d’implémentation

Paramètres de chemin

Paramètres de requête

Réponse

Exemple de requête

Exemple de réponse

Erreurs

​Paramètres de chemin

​Paramètres de requête

​Réponse

​Exemple de requête

​Exemple de réponse

​Erreurs

Paramètres de chemin

Paramètres de requête

Réponse

Exemple de requête

Exemple de réponse

Erreurs