POST /v1/mentions/search

Search for social mentions by keyword and platform. Returns scored leads matching your query.

Use case: Use this when you want to search a specific platform for mentions in real time. For example, search Twitter for people mentioning your competitor.

Rate limits: Each call counts as 1 request toward your monthly quota. Growth plan: 500 requests/month. Scale plan: unlimited. Check your remaining quota with GET /v1/usage.

Parameters

Param	Type	Required	Description
keyword	string	Yes	The search term to look for
platform	enum	No	twitter, reddit, linkedin, youtube, hackernews, quora
limit	number	No	Number of results (1-50, default 20)

Request

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

Response

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

Parameters

Request

Response

Related guides