GET /v1/signals

Récupérez les leads qualifiés avec des filtres. Retourne des résultats paginés triés par score (du plus élevé au plus bas).

Cas d'usage : Utilisez cet endpoint pour récupérer vos derniers leads qualifiés dans votre propre tableau de bord, CRM ou outil d'analyse.

Limites de requêtes : Chaque appel compte comme 1 requête dans votre quota mensuel. Plan Growth : 500 requêtes/mois. Plan Scale : 2 500 requêtes/mois. Vérifiez votre quota restant avec GET /v1/usage.

Paramètres de requête

Param	Type	Défaut	Description
keyword	string	-	Filtrer par mot-clé
intent	enum	-	ACTIVE, COMPETITOR, PAIN, QUESTION, MENTION
platform	enum	-	twitter, reddit, linkedin, youtube, hackernews
minScore	number	0	Score IA minimum (1-10)
since	ISO date	-	Uniquement les leads après cette date
limit	number	20	Résultats par page (1-100)
offset	number	0	Offset de pagination
content	enum	preview	preview ou full. full ajoute contentFull, le texte intégral du message (jusqu'à 4000 caractères). Pour les signaux détectés avant septembre 2026, contentFull peut être null : le texte intégral n'était pas encore conservé.

Requête

bash

curl "https://api.buska.io/api/v1/signals?minScore=7&intent=ACTIVE&limit=10&content=full" \
      -H "x-api-key: YOUR_KEY"

Réponse

json

{
      "signals": [
        {
          "id": "65f1a2b3c4d5e6f7a8b9c0d1",
          "author": "Mike Chen",
          "platform": "reddit",
          "intent": "ACTIVE",
          "score": 9,
          "reason": "Actively evaluating tools in this category",
          "icpMatch": "Head of Marketing",
          "content": "We need a tool that can track competitor mentions across social",
          "contentFull": "We need a tool that can track competitor mentions across social. Right now we export everything by hand every Monday and it takes half a day. Budget is around $100/mo.",
          "url": "https://reddit.com/r/saas/comments/abc123",
          "keyword": "social listening",
          "publishedAt": "2026-03-14T07:45:00Z",
          "detectedAt": "2026-03-14T07:52:00Z"
        }
      ],
      "total": 47,
      "limit": 10,
      "offset": 0,
      "usage": { "used": 47, "limit": 500, "remaining": 453 }
    }

API Buska : endpoint GET /v1/signals

GET /v1/signals

Paramètres de requête

Requête

Réponse

Guides connexes