All endpoints are GET requests under https://buyerhint.com/api/outreach/v1 and need an API key. Each returns { data, next_since }.
List people
GET /people
| Parameter | Description |
|---|
since | Optional. An ISO 8601 time. Returns records created after it. |
limit | Optional. 1 to 100, default 50. |
| Field | Description |
|---|
id | Unique ID of the person. |
full_name, title, country | Public profile details. country is a two-letter ISO 3166 code. |
email | Verified work email, or null. |
linkedin_url, x_handle, handle | Public profile links and handles. handle is platform:username. |
source, source_url | Where we found the person: x, linkedin, reddit, hackernews, github, bluesky, youtube, web, csv or manual, and the public page. |
expires_at | When the record is deleted automatically. |
company | name, domain and employee_count, or null. |
scores | One entry per ideal customer profile: icp_profile_id, score (0 to 100) and scored_at. |
created_at | When the person was added. |
List signals
GET /signals
| Parameter | Description |
|---|
since | Optional. An ISO 8601 time. Returns records created after it. |
limit | Optional. 1 to 100, default 50. |
| Field | Description |
|---|
id, person_id, company_id | The signal and who it belongs to. One of person_id or company_id is set. |
kind | like, reply, follow, quote, mention, keyword, job_change, funding, hiring or visit. |
platform | x, linkedin, reddit, hackernews, github, bluesky, youtube or web. |
origin | What we were watching: own, competitor, influencer, keyword or market. |
origin_ref | The post URL, account or keyword that produced the signal. |
url, excerpt | Link to the public activity and a short excerpt. |
occurred_at, created_at | When it happened and when we captured it. |
List drafts
GET /drafts
| Parameter | Description |
|---|
since | Optional. An ISO 8601 time. Returns records created after it. |
limit | Optional. 1 to 100, default 50. |
status | Optional. draft, approved or sent. |
| Field | Description |
|---|
id, person_id, signal_id | The draft, the person it is for and the signal it answers. |
channel, tone | Where the message goes and the tone it was written in. |
subject, body | The message. subject is null outside email. |
status | draft, approved or sent. |
approved_at, sent_at, created_at | When it was approved, marked as sent and created. |