{"uid":"cap_XGvtVsxHlCOdzksbQygOK","slug":"market-size-84b98ee7","name":"Market Size","description":"Pay-per-call machine utilities for autonomous agents.","url":"https://agent-vending-production.up.railway.app/v1/market-size?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"unit":{"enum":["household"],"type":"string","description":"Household markets only"},"filters":{"type":"array","items":{"type":"object","required":["variable","operator","value"],"properties":{"value":{"description":"number; [low, high] for between; owner|renter for tenure; true/false for children_present; married_couple|other_family|nonfamily for family_status"},"operator":{"enum":[">=",">","<","<=","==","between","in"],"type":"string"},"variable":{"enum":["household_income","tenure","householder_age","children_present","household_size","family_status","gross_rent","monthly_owner_costs","monthly_housing_cost","home_value"],"type":"string"}}},"maxItems":8,"description":"All filters are combined with AND. Dollar amounts are 2023 dollars."},"geography":{"type":"object","required":["type"],"properties":{"name":{"type":"string","description":"County name, e.g. \"Ventura County\""},"puma":{"type":"string","description":"5-digit 2020 PUMA code"},"type":{"enum":["state","county","puma","us","place","tract","zcta","county_set"],"type":"string"},"zcta":{"type":"string"},"state":{"type":"string","description":"State name, postal code or FIPS (not needed for us/zcta)"},"tract":{"type":"string"},"counties":{"type":"array","items":{"type":"object"},"description":"county_set: 2-50 counties"},"place_fips":{"type":"string"},"county_fips":{"type":"string","description":"3-digit county FIPS (alternative to name)"}},"description":"Where to size the market. Custom criteria combinations: state, puma, or a county made of whole PUMAs. us, place, tract, zcta and county_set are answered only when a published Census table covers the criteria (e.g. renter households); otherwise the request is refused, no charge.","additionalProperties":true}}},"responseSchema":{"type":"json","example":{"source":{"label":"2023 ACS 5-year, table B25003","table":"B25003","universe":"Occupied housing units (households)"},"status":"OK","criteria":["tenure=renter"],"warnings":[],"geography":{"type":"county","geoid":"06111","display_name":"Ventura County, California"},"uncertainty":{"label":"90% margin of error (official Census)","level":0.9,"lower":97600,"upper":101700,"display":"97,600–101,700 households"},"data_vintage":"ACS 2019-2023 5-year (2023 release)","estimate_type":"OFFICIAL_CENSUS_ESTIMATE","estimated_market":{"raw":99657,"count":100000,"display":"~100,000 households"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gNhcXQT2qENXcPdOAvQXA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Estimates the size of a U.S. household market segment using Census and ACS PUMS data, with a 90% margin of error for custom criteria.","exampleAgentPrompt":"How many renter households with annual income between $50,000 and $100,000 are there in Travis County, Texas? Give me a Census-backed estimate with a margin of error.","exampleUseCases":[{"title":"Rental market sizing for real estate investors","prompt":"How many renter households earning less than $50,000 a year are there in Cook County, Illinois? I want an official Census estimate I can use in a pitch deck."},{"title":"High-income family segment for consumer brand","prompt":"Estimate the number of married-couple households with children present and household income above $150,000 in California — I need this for a market sizing analysis."},{"title":"Senior homeowner market in a metro PUMA","prompt":"How many owner-occupied households with a householder aged 65 or older are in PUMA 01101 in Alabama? Give me the ACS estimate and margin of error."}],"resultDescription":"Returns the strongest defensible household count available: either an official Census published estimate or a direct ACS PUMS survey estimate, both accompanied by a 90% confidence margin of error. Unsupported geography/criteria combinations are refused without charge.","failureModes":["Unsupported geography type or criteria combination — request refused and not charged","County not composed of whole PUMAs when custom filters are used — returns refusal","Invalid filter variable, operator, or value — schema validation error","Geography not found or ambiguous name — error response","Dollar amounts outside ACS PUMS coverage range — refusal or no result","Too many filters (>8) — schema validation error"],"whenToPreferThis":"Use this endpoint when you need a statistically defensible, Census-backed estimate of a specific U.S. household market segment defined by income, tenure, age, family structure, housing costs, or other household characteristics. It is especially valuable when you need an official margin of error for investor presentations, market research, or planning. Prefer this over generic demographic APIs when the query is specifically about household counts filtered by multiple socioeconomic criteria at the state, county, or PUMA level.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:30:27.916Z","isFirstParty":false,"canonicalSlug":"market-size-84b98ee7"}