---
title: "Buying Intent"
method: GET
path: "/buying-intent"
---

# Buying Intent

`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`

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.

## Query parameters

- `key` string, required
- `company` string, required
- `domain` string, required
- `refresh` 'true'
- `level` 1 | 2

## Response `200`

Buying intent analysis result

- BuyingIntent
  - `status` 'success' | 'error'
  - `message` string: Error description — returned instead of the fields below when status is error
  - `company` string: Company name, as sent in the request
  - `domain` string: Company domain, as sent in the request
  - `intent_score` integer: 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
  - `summary` string: 2–3 sentence executive summary
  - `recommended_pitch_angle` string: One sentence on how to approach the company
  - `reasoning` string: The key signals driving the score
  - `intent_categories` object[]: Detected signals grouped by category
    - `category` 'hiring_engineering' | 'hiring_marketing' | 'hiring_sales' | 'hiring_ai' | 'hiring_customer_support' | 'hiring_general' | 'expansion' | 'funding' | 'merger_acquisition' | 'new_executive' | 'partnership' | 'customer_win' | 'new_market_entry' | 'rebranding' | 'ipo_preparation' | 'product_launch' | 'technology_adoption' | 'investment' | 'security_incident' | 'legal_regulatory' | 'financial_performance' | 'other'
    - `strength` 'high' | 'medium' | 'low': Fixed per category — how directly it implies a purchase. high = merger_acquisition, funding, new_executive, ipo_preparation, security_incident; medium = product_launch, customer_win, expansion, new_market_entry, rebranding, partnership, technology_adoption, legal_regulatory, financial_performance; low = all hiring categories, investment, other
    - `recency` 'last_30d' | 'last_90d' | 'last_180d' | 'unknown': Most recent period across the category's signals
    - `signals` object[]: One signal per real-world event
      - `text` string: Headline, job title, or snippet copied from the source
      - `period` 'last_30d' | 'last_90d' | 'last_180d' | 'unknown'
      - `date` string, date: Publish date (YYYY-MM-DD) when known; omitted otherwise
      - `sentiment` 'positive' | 'negative' | 'neutral'
      - `source_tier` 'tier_1' | 'tier_2' | 'tier_3': Best source behind the signal. tier_1 = major outlets, press wires, or the company's own domain; tier_2 = trade and tech press; tier_3 = other
      - `urls` string[]: Source links for the event — one or more; several when multiple outlets reported it
    - `recommended_solutions` string[]: B2B products or services a vendor could pitch to this company based on the category
  - `predicted_moves` object[]: Up to 5 likely near-term purchasing moves
    - `timeframe` '30_days' | '90_days' | '6_months' | '1_year'
    - `prediction` string: The predicted move, naming the tool or vendor type
    - `driven_by` string[]: The intent categories behind the prediction
  - `signal_channels` object: Which source channels returned signals
    - `news_network` boolean
    - `company_website` boolean
    - `hiring_signals` boolean
  - `growth_trajectory` 'accelerating' | 'stable' | 'decelerating' | 'restructuring', nullable
  - `company_profile` object, nullable
    - `description` string: One-sentence company description
    - `business_model` 'B2B' | 'B2C' | 'B2B2C' | 'marketplace' | 'platform' | 'infrastructure' | 'agency' | 'other', nullable
    - `industry` 'saas' | 'fintech' | 'healthtech' | 'ecommerce' | 'cybersecurity' | 'hr_tech' | 'martech' | 'legaltech' | 'edtech' | 'logistics' | 'manufacturing' | 'media' | 'consulting' | 'financial_services' | 'retail' | 'telecom' | 'real_estate' | 'energy' | 'ai' | 'other', nullable
    - `industry_vertical` string: Short phrase, e.g. payment infrastructure
  - `meta` object
    - `date_windows` object: Start dates (YYYY-MM-DD) of the 30-, 90- and 180-day windows
      - `30d` string, date
      - `90d` string, date
      - `180d` string, date

## Other responses

- `400`: Missing or invalid parameters
- `401`: Authentication required
- `402`: Insufficient credits
- `404`: No public buying signals found for this company. Not charged. The same answer is returned for up to 90 days unless `refresh=true` is passed.
- `500`: Analysis failed
- `503`: Search sources temporarily unavailable — retry shortly

---

[API](https://skmtc.dev/minelead/apis/minelead-api.md) · [All operations](https://skmtc.dev/minelead/apis/minelead-api/llms.txt) · [OpenAPI document](https://skmtc.dev/minelead/apis/minelead-api/revisions/c61c296b019b?raw)