API overview 

The Buyerhint API sends your workspace's data to your own tools: a CRM, a spreadsheet, an internal dashboard or an agent. It is read-only for now.

What you can do

• List the people in your workspace, with their company and scores.
• List signals: the replies, follows, mentions, job changes and other activity we captured.
• List message drafts and see which ones were approved or sent.
• Receive webhooks when a person, a signal or an approved draft is created.
• Work from Claude or another AI assistant through the MCP server: ask for hot leads, read why someone scored high, and save drafts for your review.

Base URL

https://buyerhint.com/api/outreach/v1

Quick start

1. Create an API key in your workspace's API settings (see authentication).
2. Call an endpoint with the key as a bearer token:

curl "https://buyerhint.com/api/outreach/v1/people?limit=1" \
  -H "Authorization: Bearer $API_KEY"

{
  "data": [
    {
      "id": "0f9c6c1e-3a52-4c1b-9d7e-2b8f4b6a1d20",
      "full_name": "Sam Rivera",
      "title": "Head of Engineering",
      "country": "CA",
      "email": "sam@example.com",
      "linkedin_url": null,
      "x_handle": "samrivera",
      "source": "x",
      "source_url": "https://x.com/samrivera/status/1850000000000000000",
      "expires_at": "2027-10-25T09:12:44.120Z",
      "created_at": "2026-10-25T09:12:44.120Z",
      "company": { "name": "Example Labs", "domain": "example.com", "employee_count": 40 },
      "scores": [{ "icp_profile_id": "6a1d…", "score": 90, "scored_at": "2026-10-25T09:13:02.511Z" }]
    }
  ],
  "next_since": "2026-10-25T09:12:44.120Z"
}

Conventions

• Requests and responses are JSON over HTTPS. Times are ISO 8601 in UTC.
• Lists return the oldest records first. To get the next page, pass the response's next_since as since. When next_since is null, you have everything.
• Every error has a JSON body with a readable message; see rate limits and errors.

Personal data you copy

People records expire 12 months after the last public activity we recorded, and people who opt out are deleted from every workspace. If you copy people into another system, keep expires_at and delete the record when it passes. See retention, opt-out and data requests.