POST /v1/mentions/search

Recherchez des mentions sociales par mot-clé et plateforme. Retourne des leads scorés correspondant à votre requête.

Cas d'usage : Utilisez cet endpoint pour rechercher des mentions sur une plateforme spécifique en temps réel. Par exemple, recherchez sur Twitter les personnes mentionnant votre concurrent.

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

Param	Type	Requis	Description
keyword	string	Oui	Le terme de recherche (200 caractères max)
platform	enum	Oui	twitter, reddit, linkedin, youtube, hackernews, bluesky, stackoverflow, medium, substack, github, devto, mastodon, quora, pinterest, facebook, instagram, tiktok, producthunt, g2 — doit également être disponible sur votre plan
limit	number	Non	Nombre de résultats (1-50, défaut 20)

Requête

bash

curl -X POST https://api.buska.io/api/v1/mentions/search \
      -H "x-api-key: YOUR_KEY" \
      -H "Content-Type: application/json" \
      -d '{"keyword": "project management tool", "platform": "twitter", "limit": 10}'

Réponse

json

{
      "keyword": "project management tool",
      "platform": "twitter",
      "count": 1,
      "mentions": [
        {
          "id": "1768245991234567890",
          "author": "Jane Smith",
          "content": "Looking for a better project management tool for our remote team. Asana is getting expensive and half the features go unused.",
          "url": "https://twitter.com/janesmith/status/123456",
          "profileUrl": "https://twitter.com/janesmith",
          "date": "2026-03-14T08:30:00Z",
          "platform": "twitter",
          "engagement": { "likes": 12, "comments": 4, "shares": 1 }
        }
      ],
      "usage": { "used": 46, "limit": 500, "remaining": 454 }
    }

Résultats bruts, non scorés. Cet endpoint interroge une plateforme en direct et renvoie les publications telles que la source nous les fournit, sans troncature de notre côté ni qualification IA. La longueur du contenu varie donc selon la plateforme. Pour des signaux scorés et confrontés à votre ICP, utilisez plutôt GET /v1/signals.

API Buska : endpoint POST /v1/mentions/search

POST /v1/mentions/search

Paramètres

Requête

Réponse

Guides connexes