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: 2,500 requests/month. Check your remaining quota with GET /v1/usage.

Parameters

Param	Type	Required	Description
keyword	string	Yes	The search term to look for (max 200 characters)
platform	enum	Yes	twitter, reddit, linkedin, youtube, hackernews, bluesky, stackoverflow, medium, substack, github, devto, mastodon, quora, pinterest, facebook, instagram, tiktok, producthunt, g2 — must also be available on your plan
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

{
      "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 }
    }

Raw, unscored results. This endpoint searches a platform live and returns posts as the source provides them, with no truncation on our side and no AI qualification. Content length therefore varies by platform. For scored signals matched against your ICP, use GET /v1/signals instead.

Buska API: POST /v1/mentions/search endpoint

POST /v1/mentions/search

Parameters

Request

Response

Related guides