Buying Intent

Analyze a company's buying intent by scanning news, the company's own website, and LinkedIn job postings from the last 180 days. Returns an intent score (0–100), signals grouped by category with source links, predicted purchasing moves, a company profile, and a recommended pitch angle.

Each signal is one real-world event, with its source links in urls: when several outlets report the same event, they are grouped into one signal listing every link.

Caching: results are cached per domain for 7 days. Within that window the cached result is returned (and charged) unless refresh=true is passed.

Cost: 5 credits per successful request, including cached results. Errors are not charged.

get/buying-intent

Request

  • Base URL: https://api.minelead.io/v1
  • URL: https://api.minelead.io/v1/buying-intent
  • Auth: API key in query parameter key

Query parameters

keystring required
Example:myApiKey

Your API key

companystring required
Example:Acme Corp

Company name

domainstring required
Example:acme.com

Company domain (without scheme)

refresh'true'
Example:true

Pass true to skip the 7-day cache and run a fresh analysis.

level1 | 2
Example:1

Signal source filter: 1 = news only, 2 = website/LinkedIn only. Omit for both (full analysis). Partial runs always run fresh and are not cached.

Response

Buying intent analysis result

status'success' | 'error'
messagestring

Error description — returned instead of the fields below when status is error

companystring

Company name, as sent in the request

domainstring

Company domain, as sent in the request

intent_scoreinteger

Computed from each category's strength and recency. 0 = no signal, 100 = very strong recent signals

intent_level'hot' | 'warm' | 'cold' | 'none'

hot=70–100, warm=40–69, cold=10–39, none=0–9

confidence'high' | 'medium' | 'low'

Based on the quality of the sources behind the signals (see source_tier)

time_sensitivity'immediate' | '3_months' | '6_months' | 'low'

How soon to reach out — immediate when a high-strength category has a signal in the last 30 days

summarystring

2–3 sentence executive summary

recommended_pitch_anglestring

One sentence on how to approach the company

reasoningstring

The key signals driving the score

growth_trajectory'accelerating' | 'stable' | 'decelerating' | 'restructuring' nullable

Example response

{
  "status": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.