Buska Documentation

Everything you need to set up, configure, and get the most out of Buska.

What is Buska?

Buska is a social listening platform built for B2B lead generation. It monitors 30+ social platforms (Twitter/X, Reddit, LinkedIn, YouTube, Hacker News, and more) for buying intent signals, scores each mention with AI, and delivers qualified leads ready for outreach.

Unlike brand monitoring tools like Mention or Brand24, Buska is designed to find buyers, not track reputation. It adds AI intent scoring, ICP matching, a Reply Studio for instant engagement, and CRM integrations so you can act on signals the moment they appear.

Key capabilities

• Monitor 30+ platforms for buying signals in real time
• AI scores every lead from 0 to 100 based on intent, freshness, and ICP match
• Match leads to your Ideal Customer Profile automatically
• Generate contextual AI replies in one click with Reply Studio
• Export to CRM, outreach tools, or custom webhooks
• Build automated workflows from signal detection to outreach

Quick Start

How to set up Buska in 5 minutes:

1. Create your account at app.buska.io/register (7-day free trial, no credit card required)
2. Enter your website - Buska AI analyzes your business and suggests keywords, competitors, and ICPs
3. Review your keywords - Add or remove keywords to track. Include competitor names, pain points, and buying phrases
4. Select platforms - Choose which social platforms to monitor (Twitter, Reddit, LinkedIn enabled by default)
5. Launch - Buska starts scanning immediately. First leads arrive within an hour

Plans & Limits

Buska offers three plans. All plans include a 7-day free trial. Annual billing saves 2 months (pay for 10, get 12).

What is included in the free trial?

Buska offers a 7-day free trial with no credit card required. Every new account gets immediate access to start finding leads. The trial is designed to let you experience the full lead generation workflow before committing to a paid plan.

What you get for free

• 5 keywords monitored across social platforms
• 30 leads per week delivered to your dashboard
• 7 sources: Twitter/X, Reddit, YouTube, Hacker News, Bluesky, Stack Overflow, LinkedIn
• AI scoring on every lead (0-100 intent score)
• 2 ICP profiles for lead matching
• 3 Prospect Finder searches
• 10 API requests to test the Buska API
• 1 automation workflow (e.g., new lead to webhook)
• Daily scan frequency

What requires a paid plan

• AI Reply Studio (contextual reply generation)
• CSV export
• Slack and Discord notifications
• CRM integrations (HubSpot, Salesforce, Pipedrive)
• Outreach integrations (Lemlist, Apollo, Instantly)
• Additional sources: TikTok, Facebook, Instagram, G2, Trustpilot, and 15+ more
• Faster scan frequency (every 3 hours or hourly)
• More keywords, leads, and team members

What happens after the trial ends?

When your 7-day trial ends, your account is locked but your data is preserved. You can upgrade to any paid plan at any time to resume monitoring. Your keywords, ICPs, and lead history remain intact.

The free trial is one-time per user. If you create a new team after using a trial, it will not receive another trial period.

Keywords & Monitoring

Keywords are the search terms Buska monitors across all your selected platforms. Each keyword is tracked independently and generates its own set of leads.

How to add keywords

1. Go to Settings > Keywords
2. Click "Add keyword"
3. Enter keyword name (e.g., "alternative to Monday.com")
4. Optional: add negative keywords to exclude irrelevant results
5. Optional: set language filter

Best practices for keywords

• Use competitor names: "alternative to [competitor]"
• Use pain points: "frustrated with [problem]"
• Use buying phrases: "looking for a [solution]"
• Use your brand name for reputation monitoring
• Keep keywords specific (3-5 words work best)

AI Scoring & Intent

Every lead is scored from 0 to 100 using a multi-factor algorithm. The score combines AI-based qualification, intent type, freshness, ICP match, and platform weight.

Intent types

How does the scoring work?

Each lead is scored from 0 to 100 using a proprietary AI model trained on thousands of buying signals since December 2023. The score combines multiple factors to surface the most relevant opportunities:

• AI qualification: Our model analyzes the content and assigns a buying intent score
• Intent type: Active demand signals score higher than general questions or brand mentions
• Freshness: Recent posts are prioritized over older ones
• ICP match: Leads matching your Ideal Customer Profile receive a significant boost
• Platform relevance: Professional platforms like LinkedIn are weighted higher

Heat levels

• Hot (60+): High buying intent, act immediately
• Warm (35-59): Moderate interest, worth engaging
• Cold (<35): Low intent, monitor for future signals

ICP Matching

ICP (Ideal Customer Profile) matching lets you filter leads based on who your ideal buyer is. Buska scores every lead against your ICP and significantly boosts the score of matching leads.

How to create an ICP

1. Go to Settings > ICP
2. Click "Add ICP"
3. Enter a name (e.g., "Head of Marketing at B2B SaaS")
4. Add target roles, industries, pain points, and intent keywords
5. Save. Buska automatically optimizes matching for your profile

Matching methods

• Keyword matching: Detects target roles, industries, pain points, and intent keywords in the lead content
• AI similarity: Our model compares the lead content with your ICP description to find conceptually relevant matches

Reply Studio

Reply Studio is a built-in AI reply generator that helps you engage with leads instantly. Available on Growth plan and above.

How it works

• Shows your top 30 qualified leads with the highest buying intent
• Choose from 3 tone presets: Expert, Peer, or Thought Leader
• AI generates a contextual reply based on the lead's content and your product
• One-click copy + open the original post to reply directly
• Replies are cached per lead + tone to avoid regeneration and save tokens

Prospect Finder

Prospect Finder lets you run natural language searches across social platforms on demand. Instead of waiting for keyword monitoring to surface leads, you describe what you are looking for and Buska finds matching results.

How it works

1. Enter a natural language query (e.g., "Find founders looking for a project management tool")
2. Our AI extracts keywords and target platforms automatically
3. Buska searches up to 8 platform queries in parallel
4. Results are scored 0-100 by relevance to your query

Available on Growth plan (20 searches/month) and Scale plan (unlimited).

Slack Integration

What it does

Slack is a team messaging platform. Buska sends real-time lead notifications directly to your Slack workspace whenever a new qualified lead is detected. Each notification includes the lead name, platform, intent type, AI score, and a link to the original post so your team can act immediately.

Plan required: All plans (Starter, Growth, Scale)

How it works

1. Buska detects a new lead matching your keywords
2. The lead is scored and qualified by AI
3. A rich notification is posted to your chosen Slack channel
4. Your team sees the lead with full context and can engage instantly

Setup steps

1. Go to Settings > Integrations in Buska
2. Click "Connect Slack"
3. Authorize Buska in your Slack workspace via OAuth
4. Select the channel where you want to receive notifications
5. Optional: set a minimum score threshold to filter low-intent leads

Data sent

Discord Integration

What it does

Discord is a community and team communication platform. Buska sends lead notifications to a Discord channel using webhooks. Each notification contains the lead name, platform, intent type, AI score, and a direct link to the original post.

Plan required: All plans (Starter, Growth, Scale)

How it works

1. Buska detects a new qualified lead
2. The lead data is formatted as a Discord embed
3. Buska posts the embed to your Discord channel via webhook
4. Your team sees the lead and can discuss or act on it in-thread

Setup steps

1. In Discord, right-click your target channel and go to Edit Channel > Integrations > Webhooks
2. Click "New Webhook" and copy the webhook URL
3. In Buska, go to Settings > Integrations
4. Click "Connect Discord"
5. Paste the webhook URL and click "Test"

Data sent

Microsoft Teams Integration

What it does

Microsoft Teams is an enterprise communication platform. Buska pushes lead notifications to Teams channels via incoming webhooks, so your sales team can see qualified leads appear right where they work. Each card includes the lead name, platform, intent, AI score, and a direct link to the original post.

Plan required: Growth, Scale

How it works

1. Buska detects and scores a new lead
2. The lead data is formatted as a Teams Adaptive Card
3. Buska posts the card to your Teams channel via webhook
4. Your team reviews the lead and takes action

Setup steps

1. In Microsoft Teams, go to your target channel, click "..." > Connectors
2. Search for "Incoming Webhook" and click "Configure"
3. Name the webhook (e.g., "Buska Leads") and copy the webhook URL
4. In Buska, go to Settings > Integrations
5. Click "Connect Microsoft Teams"
6. Paste the webhook URL and click "Test"

Data sent

Webhooks

What it does

Webhooks let you send lead data to any URL in real time. Use them to connect Buska to internal tools, custom pipelines, or any service that accepts HTTP POST requests. Webhooks are the foundation for connecting Buska to Make, n8n, Clay, and any other automation platform.

Plan required: Growth, Scale

How it works

1. Buska detects and qualifies a new lead
2. Buska sends a JSON POST request to your webhook URL
3. Your endpoint receives the full lead payload with all fields
4. Your system processes the lead (route to CRM, trigger outreach, log to database, etc.)

Setup steps

1. Go to Settings > Integrations in Buska
2. Click "Add Webhook"
3. Enter your endpoint URL (must accept POST requests)
4. Optional: add a custom header for authentication (e.g., Authorization: Bearer your-token)
5. Click "Test" to send a sample payload and verify your endpoint responds with 200

Full JSON payload

Buska sends a JSON POST request to your endpoint for every new lead. Here is the full payload structure:

{
  "event": "new_lead",
  "timestamp": "2026-03-14T10:15:00Z",
  "lead": {
    "name": "John Doe",
    "channel": "linkedin",
    "intent": "ACTIVE",
    "aiScore": 8,
    "aiReason": "Shows intent to buy CRM solution",
    "icpMatch": "CTO",
    "contentPreview": "Looking for a better CRM...",
    "postUrl": "https://...",
    "link": "https://linkedin.com/in/...",
    "keyword": "CRM",
    "publishedAt": "2026-03-14T09:00:00Z"
  },
  "enriched": {
    "email": "john@company.com",
    "phone": "+1234567890",
    "fullName": "John Doe",
    "company": "Acme Corp",
    "title": "CTO",
    "linkedinUrl": "https://linkedin.com/in/johndoe"
  }
}

Data mapping

Make Integration

What it does

Make (formerly Integromat) is a visual automation platform. Buska connects to Make via webhooks, letting you build drag-and-drop workflows that trigger whenever a new qualified lead is detected. You can route leads to any of Make's 1,500+ app integrations without writing code.

Plan required: Growth, Scale

How it works

1. Buska detects a qualified lead and sends the data to your Make webhook
2. Make receives the payload and parses all lead fields as variables
3. Your scenario routes the lead based on conditions (score, intent, platform)
4. Make pushes the lead to your CRM, outreach tool, spreadsheet, or any connected app

Setup steps

1. In Make, create a new scenario and add a "Webhooks > Custom webhook" trigger module
2. Click "Add" to create a new webhook and copy the URL
3. In Buska, go to Settings > Integrations > Webhooks
4. Add the Make webhook URL as your endpoint
5. Click "Test" in Buska to send a sample payload
6. In Make, click "Redetermine data structure" to parse the payload fields
7. Add downstream modules (e.g., HubSpot, Google Sheets, Slack) and map the lead fields

Data sent

n8n Integration

What it does

n8n is an open-source, self-hostable workflow automation platform. Buska connects to n8n via webhooks, letting you build automated lead processing pipelines on your own infrastructure. This is ideal for teams that need full control over their data flow and want to avoid third-party automation platforms.

Plan required: Growth, Scale

How it works

1. Buska detects a qualified lead and sends the data to your n8n webhook
2. n8n receives the payload and makes all lead fields available as expressions
3. Your workflow processes the lead (filter, enrich, transform)
4. n8n pushes the result to your CRM, database, or outreach tool

Setup steps

1. In n8n, create a new workflow and add a Webhook node as the trigger
2. Set the HTTP method to POST
3. Copy the production webhook URL from n8n (not the test URL)
4. In Buska, go to Settings > Integrations > Webhooks
5. Paste the n8n webhook URL and click "Test"
6. In n8n, check the execution to verify the payload was received
7. Add downstream nodes (e.g., IF node to filter by score, HTTP node to call your CRM API)

Data sent

HubSpot Integration

What it does

HubSpot is a CRM and marketing platform. Buska pushes qualified leads directly into your HubSpot CRM as new contacts, and optionally creates associated deals in your pipeline. Every contact includes enriched data, intent signals, and AI scoring so your sales team has full context from the start.

Plan required: Growth, Scale

How it works

When Buska detects someone posting "looking for a CRM", it enriches the lead with Apollo, then creates a HubSpot contact with the email, company, intent type, and AI score as custom properties. Your sales team sees the warm lead appear in their pipeline with full context.

1. Buska detects a buying signal and enriches the lead
2. A new HubSpot contact is created (or updated if the email already exists)
3. A deal is created in your selected pipeline and stage
4. Your sales team sees the lead in HubSpot with AI score, intent, and the original post

Setup steps

1. Go to Settings > Integrations in Buska
2. Click "Connect HubSpot"
3. Authorize Buska via OAuth (you will be redirected to HubSpot)
4. Select the pipeline and deal stage for new leads
5. Map Buska fields to HubSpot properties (auto-mapped by default)
6. Optional: create custom HubSpot properties for AI score, intent type, and keyword

Data sent

Salesforce Integration

What it does

Salesforce is an enterprise CRM platform. Buska exports qualified leads to Salesforce as new Leads or Contacts, with all intent signals and AI scoring data attached. This gives your sales reps immediate visibility into social buying signals within the tool they already use every day.

Plan required: Scale

How it works

1. Buska detects a buying signal and enriches the lead
2. A new Salesforce Lead or Contact record is created
3. Custom fields (AI score, intent, keyword) are populated automatically
4. An activity is logged with the original post URL and AI reasoning

Setup steps

1. Go to Settings > Integrations in Buska
2. Click "Connect Salesforce"
3. Authorize Buska via OAuth (you will be redirected to Salesforce)
4. Choose whether to create Leads or Contacts
5. Map fields (auto-mapped by default) or customize the mapping
6. Optional: set Lead assignment rules to route to specific reps

Data sent

Pipedrive Integration

What it does

Pipedrive is a sales-focused CRM. Buska pushes qualified leads into Pipedrive as Persons and Deals, so your sales pipeline fills up automatically with warm leads who have expressed buying intent on social media. Each deal is placed in your chosen pipeline stage with full context.

Plan required: Growth, Scale

How it works

1. Buska detects a buying signal and enriches the lead
2. A Person is created in Pipedrive with contact details
3. A Deal is created and linked to the Person in your selected pipeline
4. A Note is attached with the AI score, intent, and original post link

Setup steps

1. In Pipedrive, go to Settings > Personal preferences > API and copy your API token
2. In Buska, go to Settings > Integrations
3. Click "Connect Pipedrive"
4. Paste your Pipedrive API token
5. Select the target pipeline and deal stage
6. Map fields or use the defaults

Data sent

Lemlist Integration

What it does

Lemlist is a cold email and outreach platform. When Buska detects a qualified lead on social media, it can automatically add that lead to a Lemlist campaign. The lead arrives with their email, name, company, and custom variables like AI score and intent type, ready for your outreach sequence.

Plan required: Growth, Scale

How it works in practice

1. Buska detects a buying signal on Twitter, Reddit, or LinkedIn
2. The automation workflow enriches the lead via Apollo (to get their email)
3. If an email is found, Buska pushes the lead to your Lemlist campaign
4. Lemlist starts the outreach sequence automatically
5. You reply to warm prospects who already expressed intent

Setup steps

1. Get your Lemlist API key from Lemlist > Settings > Integrations
2. In Buska, go to Settings > Integrations > Connect Lemlist
3. Paste your API key and test the connection
4. Create an automation workflow: Trigger "new_lead" > Step 1: Enrich with Apollo > Step 2: Export to Lemlist
5. Select your target campaign in the workflow step config
6. Set conditions: min AI score >= 7, intent types ACTIVE or COMPETITOR

Data pushed to Lemlist

Apollo Integration

What it does

Apollo is a B2B data enrichment and sales engagement platform. Buska uses Apollo in two ways: as an enrichment source to find email addresses, phone numbers, and company info for your leads, and as an outreach destination to add enriched leads to Apollo sequences for automated follow-up.

Plan required: Growth, Scale

How it works

1. Buska detects a lead and sends the profile URL or name to Apollo for enrichment
2. Apollo returns the email, phone, company, title, and LinkedIn URL
3. The enriched data is stored with the lead in Buska
4. Optionally, the lead is added to an Apollo sequence for automated outreach

Setup steps

1. In Apollo, go to Settings > Integrations > API Keys and create a new key
2. In Buska, go to Settings > Integrations
3. Click "Connect Apollo"
4. Paste your Apollo API key
5. Enable enrichment to auto-enrich new leads
6. Optional: select an Apollo sequence to add enriched leads to

Data sent / received

Instantly Integration

What it does

Instantly is a cold email outreach platform optimized for deliverability. Buska pushes enriched, qualified leads directly into your Instantly campaigns, so you can start outreach to people who have already expressed buying intent on social media.

Plan required: Growth, Scale

How it works

1. Buska detects a buying signal and enriches the lead (via Apollo)
2. If an email is found, Buska adds the lead to your Instantly campaign
3. Instantly starts the email sequence automatically
4. You follow up with prospects who respond

Setup steps

1. In Instantly, go to Settings > API > API Keys and generate a new key
2. In Buska, go to Settings > Integrations
3. Click "Connect Instantly"
4. Paste your Instantly API key
5. Select the campaign to add leads to
6. Map lead fields to Instantly variables

Data sent

La Growth Machine Integration

What it does

La Growth Machine (LGM) is a multi-channel outreach platform that combines LinkedIn, email, and Twitter in a single sequence. Buska pushes qualified leads into LGM audiences, where they are automatically enrolled in your multi-channel outreach campaign.

Plan required: Growth, Scale

How it works

1. Buska detects a qualified lead and enriches their profile
2. The lead is pushed to your LGM audience with LinkedIn URL, email, and phone
3. LGM auto-enrolls the lead in your selected campaign
4. LGM reaches out via LinkedIn, email, and Twitter in sequence

Setup steps

1. In LGM, go to Settings > API and generate your API key
2. In Buska, go to Settings > Integrations
3. Click "Connect La Growth Machine"
4. Paste your LGM API key
5. Select the audience to add leads to
6. Optional: choose a campaign to auto-enroll leads immediately

Data sent

Clay Integration

What it does

Clay is a data enrichment and workflow platform with access to 75+ data providers. Buska sends leads to Clay tables via webhooks, where Clay can layer on additional enrichment (company size, funding, tech stack, etc.) and then push the fully enriched lead to your CRM or outreach tool.

Plan required: Growth, Scale

How it works

1. Buska detects a qualified lead and sends it to your Clay table webhook
2. Clay receives the lead and runs your enrichment columns (email finder, company lookup, etc.)
3. Clay pushes the fully enriched lead to your CRM or outreach tool

Setup steps

1. In Clay, create a new table and click "Add source" > "Webhook"
2. Copy the Clay webhook URL
3. In Buska, go to Settings > Integrations > Webhooks
4. Add the Clay webhook URL as your endpoint
5. Click "Test" to send a sample payload and register the schema in Clay
6. In Clay, add enrichment columns (e.g., "Find email", "Company info", "LinkedIn profile")
7. Add a push destination (e.g., HubSpot, Lemlist, Google Sheets)

Data sent

Airtable Integration

What it does

Airtable is a flexible database and collaboration platform. Buska exports leads to Airtable bases as new rows, giving your team a spreadsheet-like view of all qualified leads. This is ideal for custom tracking, reporting, and workflows that do not fit neatly into a traditional CRM.

Plan required: Growth, Scale

How it works

1. Buska detects a qualified lead
2. The lead data is pushed to your Airtable table as a new row
3. Each field maps to an Airtable column (name, score, intent, etc.)
4. Your team can filter, sort, and build views on the data

Setup steps

1. In Airtable, go to Account > Developer hub > Personal access tokens and create a token with read/write access to your base
2. In Buska, go to Settings > Integrations
3. Click "Connect Airtable"
4. Paste your Airtable token or authorize via OAuth
5. Select the base and table
6. Map Buska fields to Airtable columns (or use auto-mapping)

Data sent

Notion Integration

What it does

Notion is a workspace and documentation platform with powerful databases. Buska pushes leads into Notion databases as new pages, with all lead properties mapped to database columns. This is great for teams that use Notion as their central workspace and want leads visible alongside other projects.

Plan required: Growth, Scale

How it works

1. Buska detects a qualified lead
2. A new page is created in your Notion database with all lead properties
3. The page body contains the content preview, AI reasoning, and post link
4. Your team can filter, sort, and add status tags directly in Notion

Setup steps

1. In Notion, go to Settings > Connections > Develop or manage integrations and create a new integration
2. Share your target database with the integration (click "..." on the database, then "Connect to")
3. In Buska, go to Settings > Integrations
4. Click "Connect Notion"
5. Authorize Buska in your Notion workspace
6. Select the database to push leads to
7. Map Buska fields to Notion properties

Data sent

CSV Export

Export your leads as a CSV file for offline analysis, custom reporting, or importing into any tool that accepts CSV files. Available on Growth plan and above.

How to export

1. Go to Settings > Export
2. Select date range and filters (optional)
3. Click "Export CSV"
4. Download the file

CSV columns

• Name
• Channel
• Keyword
• Intent
• ICP Match
• AI Score
• AI Reason
• Content
• Post URL
• Profile URL
• Published At

Workflow Builder

The Workflow Builder lets you create automated pipelines that run whenever a new lead matches your criteria. Chain triggers, conditions, and actions to build custom lead processing workflows.

Triggers

• new_lead: Fires when a new lead is detected
• new_competitor_mention: Fires when a competitor is mentioned
• scheduled: Runs at a set interval (hourly, daily, weekly)
• manual: Triggered manually from the dashboard

Conditions

• Minimum AI score: Only process leads above a threshold (e.g., score >= 7)
• Intent types: Filter by ACTIVE, COMPETITOR, PAIN, QUESTION, or MENTION
• Channels: Filter by platform (Twitter, Reddit, LinkedIn, etc.)
• Keywords: Filter by specific keywords
• ICP names: Filter by matched ICP profile

Actions

• Notify: Send to Slack, Discord, or a webhook
• Export: Push to a CRM (HubSpot, Salesforce, Pipedrive) or outreach tool (Lemlist, Instantly, Apollo, LGM)
• Enrich: Enrich lead data with Apollo or Clay before exporting

Automation Templates

Start with a pre-built template and customize it for your workflow. Templates are available in the Workflow Builder under the "Templates" tab.

Available templates

Triggers & Conditions

Triggers define when a workflow runs. Conditions filter which leads pass through to the next step. Combine them to build precise automation rules.

Trigger types

Condition operators

• equals: Field matches exactly (e.g., intent = "ACTIVE")
• greater_than: Numeric comparison (e.g., aiScore > 7)
• contains: String includes substring (e.g., keyword contains "CRM")
• in: Field is one of a list (e.g., channel in ["twitter", "linkedin"])
• not_empty: Field has a value (e.g., enriched.email is not empty)

API Authentication

All API requests require an API key passed in the x-api-key header.

x-api-key: your-api-key-here

Getting your API key

1. Go to Settings > API in the Buska dashboard
2. Click "Generate API Key"
3. Copy the key and store it securely

Rate limits

GET /v1/usage

Returns your current API usage and plan information.

Use case: Use this to monitor your API quota before making bulk requests, or to display usage info in your own dashboard.

Request

curl -H "x-api-key: YOUR_KEY" https://api.buska.io/api/v1/usage

Response

{
  "team": "Acme Corp",
  "plan": "growth",
  "usage": {
    "used": 45,
    "limit": 500,
    "remaining": 455
  }
}

Response fields

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.

Parameters

Request

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

{
  "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/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.

Parameters

Request

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

{
  "qualified": true,
  "score": 8,
  "intent": "ACTIVE",
  "icpMatch": "CTO",
  "reason": "Shows buying signal for CRM solutions"
}

Response fields

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.

Query parameters

Request

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

Response

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

MCP Server Setup

The Buska MCP (Model Context Protocol) server lets AI assistants like Claude access your Buska data directly. It exposes search, scoring, and signal retrieval as tools that AI agents can call.

Configuration

Add the following to your MCP client configuration file (e.g., claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "buska": {
      "command": "npx",
      "args": ["-y", "@buska/mcp-server"],
      "env": {
        "BUSKA_API_KEY": "your-api-key"
      }
    }
  }
}

Requirements

• Node.js 18 or later
• A valid Buska API key (Growth or Scale plan)
• An MCP-compatible AI client (Claude Desktop, Claude Code, or similar)

Testing the connection

After adding the configuration, restart your AI client. You should see "buska" listed as an available MCP server. Try asking: "Search Twitter for people looking for a CRM tool."

MCP Available Tools

The Buska MCP server exposes 3 tools that AI assistants can call:

1. search_mentions

Search social mentions by keyword and platform. Equivalent to the POST /v1/mentions/search API endpoint.

2. score_lead

AI-powered B2B lead qualification. Equivalent to the POST /v1/leads/score API endpoint.

3. get_signals

Retrieve qualified leads with filters. Equivalent to the GET /v1/signals API endpoint.

Example usage with Claude

Once the MCP server is connected, you can ask Claude natural language questions like:

• "Search Twitter for people looking for a CRM tool and score the results"
• "Find the top 5 hot leads from LinkedIn this week"
• "Score this Reddit post for buying intent: [paste text]"
• "Get all ACTIVE signals with a score above 7 from the last 24 hours"

Practical example: multi-step AI agent workflow

Try asking Claude a complex query that chains multiple tools together:

Ask Claude: "Search Twitter for people looking for a CRM tool, score the top results, and show me the ones with buying intent above 70"

Claude will automatically:

1. Call search_mentions with keyword "CRM tool" on Twitter
2. Call score_lead for each result to get detailed scoring
3. Filter results where the score exceeds 70
4. Present a summary table with the qualified leads, their scores, and reasoning

Need help?

If you have questions about integrating Buska into your workflow, we are here to help.

• Email : hello@buska.io
• Live chat: Available in the bottom-right corner of the app
• Book a demo: Schedule a call