{"uid":"cap_iaCH5pg58f3Lf0TOXPzZv","slug":"providersignal-market-positioning-api-a3046e9f","name":"ProviderSignal Market Positioning API","description":"Healthcare market intelligence API. Unified provider directory + acquisition signals + license-events feed across all 50 US states, derived from NPI + state dental boards + CMS Medicare + OIG LEIE + state Medicaid + HRSA HPSA designations. All responses ship a citation envelope (`meta.envelope_version`, `meta.source_attribution`, `meta.request`) so agents can verify source freshness without out-of-band validation. Paid `/api/v1/agent/*` endpoints accept two per-call rails on a single 402: x402 (USDC on Base mainnet) and MPP (Stripe card via a Shared Payment Token), plus Bearer-token subscription auth for existing API keys. See [/docs/agent-payments](/docs/agent-payments) for the full flow. See [/docs/fields](/docs/fields) for the field glossary and [/llms.txt](/llms.txt) for the LLM crawler index.","url":"https://providersignal.com/api/v1/agent/market/positioning","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["state"],"properties":{"zip":{"type":"string","description":"Optional 3-digit ZIP prefix for metro-grain scope (e.g. '770' for Houston). Omit for whole-state."},"state":{"type":"string","pattern":"^[A-Z]{2}$","description":"Single 2-letter enriched-state code (e.g. TX). Required."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"object","properties":{"band":{"enum":["Premium","Average","Discount"],"type":"string"},"scope":{"type":"object","properties":{"grain":{"enum":["state","zip_prefix"],"type":"string"},"state":{"type":"string"},"zip_prefix":{"type":["string","null"]}}},"score":{"type":"number","description":"0-100 positioning score; 50 = the national benchmark midpoint."},"inputs":{"type":"object","properties":{"dso_pct":{"type":["number","null"]},"median_income":{"type":["number","null"]},"providers_per_10k":{"type":["number","null"]},"retirement_cliff_pct":{"type":["number","null"]}}},"factors":{"type":"object","properties":{"scarcity":{"type":"number"},"demographics":{"type":"number"},"dso_competition":{"type":"number"},"supply_pressure":{"type":"number"}}},"modifier":{"type":"number"},"benchmark":{"type":"object","properties":{"tier":{"type":"string"},"collections_pct":{"type":["string","null"]},"ebitda_multiple":{"type":"string"}}},"confidence":{"type":"number","description":"0-100. Below 50 the band should be treated as Preliminary."},"disclaimer":{"type":"string"},"active_dentists":{"type":"integer"}},"additionalProperties":true},"meta":{"type":"object","required":["envelope_version"],"properties":{"request":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string"},"billed_credits":{"type":"integer"},"billing_method":{"enum":["subscription","per_query","free","admin"],"type":"string"}}},"envelope_version":{"type":"string"},"source_attribution":{"type":"array","items":{"type":"object","properties":{"table":{"type":"string"},"license":{"type":"string"},"last_refresh":{"type":["string","null"]},"schema_version":{"type":"string"}}},"description":"Per-source citation: logical table, last successful refresh, schema version, license posture."}},"additionalProperties":true},"error":{"type":["object","null"],"description":"Null on success; { code, message } on failure."}}}}}}},"responseSchema":{"type":"json","example":{"data":{"band":"Average","scope":{"grain":"zip_prefix","state":"TX","zip_prefix":"770"},"score":50,"inputs":{"dso_pct":5.7,"median_income":69860,"providers_per_10k":3.75,"retirement_cliff_pct":20.9},"factors":{"scarcity":40,"demographics":40,"dso_competition":60,"supply_pressure":60},"modifier":1,"benchmark":{"tier":"solo","collections_pct":"65-85%","ebitda_multiple":"2.5-5x"},"confidence":100,"disclaimer":"Market-attractiveness positioning vs the public national benchmark. Not a transaction comp and not a practice-specific valuation.","active_dentists":1201},"meta":{"envelope_version":"1.0"},"error":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-hRUJPh_Yx3EFd1OYSYes","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a dental market attractiveness positioning score (0-100), band, and benchmark data for a given US state or ZIP prefix, derived from provider density, demographics, DSO competition, and retirement trends.","exampleAgentPrompt":"What's the dental market positioning score for the Houston area in Texas — is it a Premium, Average, or Discount market, and what EBITDA multiple range should I expect?","exampleUseCases":[{"title":"Dental DSO acquisition target screening","prompt":"I'm evaluating dental practices to acquire in Texas. Can you pull the market positioning score and EBITDA benchmark for the Houston metro ZIP prefix 770 so I know if it's a premium or discount market?"},{"title":"State-level market entry decision","prompt":"We're thinking about expanding our dental group into California. Can you get me the statewide market positioning score and tell me whether it's classified as Premium, Average, or Discount compared to the national benchmark?"},{"title":"Provider scarcity and HPSA signal check","prompt":"I need to know if there's a dentist shortage in Colorado — can you pull the market positioning data for CO so I can see the scarcity factor and how many active dentists there are relative to the national benchmark?"}],"resultDescription":"Returns a JSON object with a 0-100 positioning score, a band label (Premium/Average/Discount), scope metadata (state, ZIP prefix grain), raw input signals (providers per 10k, DSO penetration %, median income, retirement cliff %), factor scores (scarcity, demographics, DSO competition, supply pressure), a benchmark tier with collections % range and EBITDA multiple, a confidence score (0-100), active dentist count, a disclaimer, and a citation envelope with source attribution and envelope version.","failureModes":["Missing required 'state' query parameter returns a 400 validation error","Invalid state code format (not 2 uppercase letters) returns a 400 pattern validation error","Invalid ZIP prefix format or out-of-range prefix may return a 400 or empty data response","Insufficient data for a very small ZIP prefix may return confidence below 50 with a Preliminary band","402 payment required if no valid Bearer token and no x402/MPP payment rail is provided","Rate limiting or quota exhaustion may return a 429 error for high-frequency callers"],"whenToPreferThis":"Use this endpoint when you need a scored, benchmarked view of dental market attractiveness at state or metro (ZIP prefix) grain — especially for acquisition screening, market entry decisions, or DSO competitive analysis. Prefer this over raw NPI directory lookups when you need a composite intelligence signal (supply, demographics, competition, retirement trends) rather than individual provider records. This endpoint is the right choice when EBITDA multiple ranges and market band classification (Premium/Average/Discount) are needed for financial modeling or deal sourcing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:44:02.104Z","isFirstParty":false}