Use casesSaaS CompaniesMarketing AgenciesSales TeamsGrowth TeamsBlogPricingMCPNewDocs
Start free trial

GET /v1/signals

Retrieve qualified leads with filters. Returns paginated results sorted by score (highest first).

Use case: Use this to pull your latest qualified leads into your own dashboard, CRM, or analytics tool.

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.

Query parameters

ParamTypeDefaultDescription
keywordstring-Filter by keyword
intentenum-ACTIVE, COMPETITOR, PAIN, QUESTION, MENTION
platformenum-twitter, reddit, linkedin, youtube, hackernews
minScorenumber0Minimum AI score (0-10)
sinceISO date-Only leads after this date
limitnumber20Results per page (1-50)
offsetnumber0Pagination offset

Request

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

Response

json
{
      "signals": [
        {
          "name": "Mike Chen",
          "channel": "reddit",
          "intent": "ACTIVE",
          "aiScore": 9,
          "aiReason": "Actively evaluating tools in this category",
          "icpMatch": "Head of Marketing",
          "contentPreview": "We need a tool that can track competitor mentions across social...",
          "postUrl": "https://reddit.com/r/saas/comments/abc123",
          "link": "https://reddit.com/u/mikechen",
          "keyword": "social listening",
          "publishedAt": "2026-03-14T07:45:00Z"
        }
      ],
      "total": 47,
      "limit": 10,
      "offset": 0,
      "usage": { "used": 47, "limit": 500, "remaining": 453 }
    }

Related guides