# HealthParse Manufacturers Year-Over-Year Spend Increase Search

> HealthParse Manufacturers Year-Over-Year Spend Increase Search is a paid API for AI agents from api.healthparse.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns manufacturers/GPOs whose total Open Payments spend genuinely increased year-over-year, with real dollar and percent deltas between two program years.

## Facts

- Endpoint: GET https://api.healthparse.io/v1/manufacturers/yoy-increase/search
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthparse-manufacturers-year-over-year-spend-increase-search-8c867247
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n89lSkAQ4NyDxbOrqn4aT

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 healthparse-manufacturers-year-over-year-spend-increase-search-8c867247
```

Example prompt: Which pharmaceutical manufacturers genuinely increased their Open Payments spending on cardiologists by at least $25,000 and 15% between 2023 and 2024 — show me the top 20 results filtered to California?

## When to prefer this

Use this endpoint when you need to identify manufacturers or GPOs whose Open Payments spending is genuinely growing — not just large spenders — with verifiable year-over-year deltas. Prefer this over the manufacturer discovery endpoint when growth trajectory matters, not absolute spend size. Ideal for competitive intelligence, compliance monitoring, and sales targeting where trend direction is the key signal.

## Known failure modes

- total_matched returns 0 when prior year data has not been imported — endpoint is honest about data availability rather than fabricating results
- invalid state code returns empty results or validation error
- min_pct_change or min_increase_usd set too high may return zero results
- year/prior_year combination not available if that year pair hasn't been loaded
- rate limit or payment failure due to x402 micropayment not processed

## How this service works

Manufacturers/GPOs whose TOTAL Open Payments spend genuinely increased year-over-year — a real per-manufacturer delta (amount_current vs amount_prior), not a magnitude threshold. Defaults to 2023→2024 (any loaded year pair via year/prior_year). Filter: specialty, state, min_increase_usd (default $10,000), min_pct_change (default 10%). NOTE: op_manufacturer_payments holds only PY2024 today — real, returns total_matched=0 (never fabricated) until a prior year is imported; see stage1b-report.md.

## Output

A paginated list of manufacturers and GPOs whose total Open Payments spend increased year-over-year, including current and prior year totals, the dollar increase, and the percent change. Also returns total_matched count (returns 0 if prior year data is not yet loaded).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "year": {
     "type": "integer",
     "description": "current program year (default 2024, the latest loaded)"
    },
    "limit": {
     "type": "integer",
     "default": 25,
     "maximum": 100
    },
    "state": {
     "type": "string",
     "description": "2-letter recipient state code(s), comma-separated"
    },
    "offset": {
     "type": "integer",
     "default": 0
    },
    "specialty": {
     "type": "string",
     "description": "recipient specialty substring, e.g. 'Cardiology'"
    },
    "prior_year": {
     "type": "integer",
     "description": "comparison program year (default year-1)"
    },
    "min_pct_change": {
     "type": "number",
     "description": "minimum percent increase (default 10)"
    },
    "min_increase_usd": {
     "type": "number",
     "description": "minimum dollar increase (default 10000)"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthparse-manufacturers-year-over-year-spend-increase-search-8c867247/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthparse.io](https://www.zero.xyz/host/api.healthparse.io/llms.txt)