{"uid":"cap_n89lSkAQ4NyDxbOrqn4aT","slug":"healthparse-manufacturers-year-over-year-spend-increase-search-8c867247","name":"HealthParse Manufacturers Year-Over-Year Spend Increase Search","description":"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.","url":"https://api.healthparse.io/v1/manufacturers/yoy-increase/search","method":"GET","headers":{},"bodySchema":{"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)"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8ogNlDRDza_3X9EXZ_GYB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns manufacturers/GPOs whose total Open Payments spend genuinely increased year-over-year, with real dollar and percent deltas between two program years.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pharma sales growth targeting in oncology","prompt":"Find me the top 25 manufacturers that meaningfully increased their Open Payments spending on oncology physicians between 2023 and 2024 — at least $50,000 more and a 10% rise — so I can see who's ramping up in that specialty."},{"title":"State-level compliance monitoring for Texas","prompt":"Which medical device manufacturers or GPOs significantly grew their physician payments in Texas year-over-year from 2023 to 2024, with at least a $20,000 dollar increase and 10% percent change? Give me up to 50 results."},{"title":"Competitive intelligence for market entry","prompt":"Show me all manufacturers that increased their Open Payments total spend by at least $100,000 and 20% from 2023 to 2024 across any specialty — I want to spot companies aggressively expanding their physician payment programs."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:52:29.661Z","isFirstParty":false}