POST /v1/leads/score
Score any text content for buying intent. Pass a social post, comment, or message and receive an AI-powered lead qualification score.
Use case: Use this to qualify content from any source. Feed it a social media post and get back an intent score, ICP match, and AI reasoning.
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 |
|---|---|---|---|
| content | string | Yes | The text to score (min 10 characters) |
| keyword | string | No | Keyword for context-aware scoring |
| context | string | No | Additional context about your product/service |
Request
bash
curl -X POST https://api.buska.io/api/v1/leads/score \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Looking for a CRM that integrates with Slack", "keyword": "CRM"}'Response
json
{
"qualified": true,
"score": 8,
"intent": "ACTIVE",
"icpMatch": "CTO",
"reason": "Shows buying signal for CRM solutions"
}Response fields
| Field | Type | Description |
|---|---|---|
| qualified | boolean | Whether the content shows buying intent |
| score | number | AI score from 0-10 |
| intent | string | Intent type (ACTIVE, COMPETITOR, PAIN, QUESTION, MENTION) |
| icpMatch | string | null | Matched ICP name, or null |
| reason | string | AI explanation of the score |
Related guides
- API ReferencePOST /v1/mentions/searchSearch social media mentions on a specific platform. Returns posts with content, author, URL, engagement. Used for real-time lead scraping.
- API ReferenceGET /v1/signalsPull qualified leads already detected and scored by your Buska pipeline. Filter by keyword, intent, platform, score, date.
- Core FeaturesAI ScoringBuska's AI scores every lead from 0 to 100 based on buying intent, freshness, ICP match, and engagement. Learn how the scoring works and how to filter for high-intent prospects.