POST /v1/mentions/search

Recherchez des mentions sociales par mot-cle et plateforme. Retourne des leads scores correspondant a votre requete.

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

Limites de requetes : Chaque appel compte comme 1 requete dans votre quota mensuel. Plan Growth : 500 requetes/mois. Plan Scale : illimite. Verifiez votre quota restant avec GET /v1/usage.

Parametres

Param	Type	Requis	Description
keyword	string	Oui	Le terme de recherche
platform	enum	Non	twitter, reddit, linkedin, youtube, hackernews, quora
limit	number	Non	Nombre de resultats (1-50, defaut 20)

Requete

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}'

Reponse

json

{
      "results": [
        {
          "name": "Jane Smith",
          "channel": "twitter",
          "intent": "ACTIVE",
          "aiScore": 9,
          "aiReason": "Actively searching for a project management solution",
          "contentPreview": "Looking for a better project management tool for our remote team...",
          "postUrl": "https://twitter.com/janesmith/status/123456",
          "link": "https://twitter.com/janesmith",
          "keyword": "project management tool",
          "publishedAt": "2026-03-14T08:30:00Z"
        }
      ],
      "total": 1,
      "usage": { "used": 46, "limit": 500, "remaining": 454 }
    }

POST /v1/mentions/search

Parametres

Requete

Reponse

Guides connexes