# Bytemine Buying Intent Scorer

> Bytemine Buying Intent Scorer is a paid API for AI agents from agents.bytemine.ai, paid per call via MPP or x402, $0.01/call, status healthy (last checked 2026-10-12, last successful call 2026-09-25).

Scores company domains (or discovers in-market companies) using a multi-signal 0–100 buying intent score fusing hiring velocity, funding recency, technographics, and competitor displacement.

## Facts

- Endpoint: POST https://agents.bytemine.ai/functions/v1/api-gateway/v1/intent/score?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP, x402
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-09-25
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Provider: agents.bytemine.ai
- Website: https://agents.bytemine.ai
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-bytemine-ai-bytemine-buying-intent-scorer-223dff35
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z7AHxOMXrRV8o-Jm2PLXj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-bytemine-ai-bytemine-buying-intent-scorer-223dff35 -d '<json body>'
```

Example prompt: Score these 10 domains — salesforce.com, hubspot.com, pipedrive.com, close.com, monday.com, notion.so, airtable.com, clickup.com, asana.com, linear.app — against our ICP: companies hiring for 'RevOps' and 'Sales Engineer' roles, using Marketo or Salesforce, over the last 30 days, and only return companies with a score of 50 or higher.

## When to prefer this

Use this endpoint when you need to quantitatively rank or discover B2B accounts by buying intent using multi-dimensional signals (hiring, funding, technographics, competitor displacement). Prefer this over simple company enrichment when you need a prioritized, scored list rather than just firmographic data, and over contact search when the goal is account-level prioritization rather than finding individuals. Best suited for outbound sales prioritization, pipeline warming, and ABM campaign targeting.

## Known failure modes

- Invalid domain format returns a validation error
- Domains array exceeding 25 items is rejected
- Days value outside 1–90 range returns a 400 error
- No matching companies found in discover mode returns an empty companies array
- Insufficient credits/payment failure returns a 402 error
- Unknown or unsupported industry/location string may return zero results

## How this service works

Score the domains you supply (mode score) or let discovery surface in market companies ranked by intent (mode discover). Fuses hiring velocity, role fit hiring, funding recency, technographic fit, competitor displacement, and optionally senior leadership changes into a 0 to 100 score with reason codes and per component sub scores. Billed per company scored.

## Output

Returns a list of companies each with: a 0–100 intent_score, a tier label (hot/warm/monitor/cold), an array of reason_codes explaining the score, a signals object with raw signal data, and a components object with per-signal sub-scores (hiring velocity, role fit, funding recency, technographic fit, competitor displacement, optionally leadership changes). Also returns the mode used and total count of companies scored.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "icp": {
   "type": "object",
   "properties": {
    "technologies": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Technologies that indicate fit."
    },
    "hiring_titles": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Roles whose hiring implies demand."
    },
    "competitor_technologies": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Competitor products that mark a displacement target."
    }
   }
  },
  "days": {
   "type": "integer",
   "description": "Signal lookback window in days, 1 to 90. Default 30."
  },
  "mode": {
   "enum": [
    "score",
    "discover"
   ],
   "type": "string",
   "description": "Inferred from the body when omitted."
  },
  "limit": {
   "type": "integer",
   "description": "Companies to score, 1 to 25. Default 10."
  },
  "domain": {
   "type": "string",
   "description": "Single domain shortcut."
  },
  "domains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Domains to score in mode score."
  },
  "industry": {
   "type": "string",
   "description": "Restrict discovery to one industry."
  },
  "location": {
   "type": "string",
   "description": "Restrict discovery by job posting location."
  },
  "min_score": {
   "type": "integer",
   "description": "Only return companies at or above this score."
  },
  "include_leadership_changes": {
   "type": "boolean",
   "description": "Add the senior job change signal. Slower. Default false."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "type": "string"
  },
  "scored": {
   "type": "integer"
  },
  "companies": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "tier": {
      "enum": [
       "hot",
       "warm",
       "monitor",
       "cold"
      ],
      "type": "string"
     },
     "domain": {
      "type": "string"
     },
     "signals": {
      "type": "object"
     },
     "components": {
      "type": "object"
     },
     "company_name": {
      "type": "string"
     },
     "intent_score": {
      "type": "number"
     },
     "reason_codes": {
      "type": "array",
      "items": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-bytemine-ai-bytemine-buying-intent-scorer-223dff35/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.bytemine.ai](https://www.zero.xyz/host/agents.bytemine.ai/llms.txt)