{"slug":"agent-vending-production-up-railway-app-v1-market-size-10e540","title":"Estimate the size of a U.S","host":"agent-vending-production.up.railway.app","method":"POST","resource":"https://agent-vending-production.up.railway.app/v1/market-size","category":"market","description":"Estimate the size of a U.S. household market using Census data, e.g. renter households in a county or high-income families with children in a state. Returns the strongest defensible result available: an official Census estimate or a direct ACS PUMS survey estimate with a 90% margin of error. Custom ","price_listed":0.5,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1364,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"filters":[{"operator":"==","value":"renter","variable":"tenure"}],"geography":{"name":"Ventura County","state":"CA","type":"county"},"unit":"household"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"examples":[{"filters":[{"operator":"==","value":"renter","variable":"tenure"}],"geography":{"name":"Ventura County","state":"CA","type":"county"},"unit":"household"},{"filters":[{"operator":">=","value":150000,"variable":"household_income"},{"operator":"==","value":true,"variable":"children_present"},{"operator":">=","value":3,"variable":"household_size"}],"geography":{"state":"TX","type":"state"},"unit":"household"},{"filters":[{"operator":">=","value":100000,"variable":"household_income"},{"operator":"==","value":"renter","variable":"tenure"}],"geography":{"puma":"03703","state":"CA","type":"puma"},"unit":"household"},{"filters":[{"operator":">=","value":150000,"variable":"household_income"},{"operator":"==","value":"owner","variable":"tenure"},{"operator":"between","value":[35,54],"variable":"householder_age"},{"operator":"==","value":true,"variable":"children_present"}],"geography":{"name":"Ventura County","state":"CA","type":"county"},"unit":"household"}],"properties":{"filters":{"description":"All filters are combined with AND. Dollar amounts are 2023 dollars.","items":{"properties":{"operator":{"enum":[">=",">","<","<=","==","between","in"],"type":"string"},"value":{"description":"number; [low, high] for between; owner|renter for tenure; true/false for children_present; married_couple|other_family|nonfamily for family_status"},"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"}},"required":["variable","operator","value"],"type":"object"},"maxItems":8,"type":"array"},"geography":{"additionalProperties":true,"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.","properties":{"counties":{"description":"county_set: 2-50 counties","items":{"type":"object"},"type":"array"},"county_fips":{"description":"3-digit county FIPS (alternative to name)","type":"string"},"name":{"description":"County name, e.g. \"Ventura County\"","type":"string"},"place_fips":{"type":"string"},"puma":{"description":"5-digit 2020 PUMA code","type":"string"},"state":{"description":"State name, postal code or FIPS (not needed for us/zcta)","type":"string"},"tract":{"type":"string"},"type":{"enum":["state","county","puma","us","place","tract","zcta","county_set"],"type":"string"},"zcta":{"type":"string"}},"required":["type"],"type":"object"},"unit":{"description":"Household markets only","enum":["household"],"type":"string"}},"required":["geography","filters"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"description":"HTTP 200 = result (charged). Refusals are never charged: 422 NOT_SUPPORTED (geography/criteria not supported, or survey quality gates failed), 400 INVALID_QUERY, 503 DATA_UNAVAILABLE, 502 UPSTREAM_ERROR; refusals include reason_code, reason, alternatives and charged=false.","properties":{"alternatives":{"type":"array"},"charged":{"type":"boolean"},"criteria":{"items":{"type":"string"},"type":"array"},"data_vintage":{"type":"string"},"estimate_type":{"enum":["OFFICIAL_CENSUS_ESTIMATE","OFFICIAL_AGGREGATED","DIRECT_PUMS_DESIGN_BASED_ESTIMATE"],"type":"string"},"estimated_market":{"type":"object"},"geography":{"type":"object"},"reason_code":{"type":"string"},"sample_quality":{"type":"object"},"source":{"type":"object"},"status":{"enum":["OK","NOT_SUPPORTED","INVALID_QUERY","DATA_UNAVAILABLE","UPSTREAM_ERROR"],"type":"string"},"uncertainty":{"type":"object"},"warnings":{"type":"array"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-26","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":false,"latency_ms":1364,"error":null}],"description_full":"Estimate the size of a U.S. household market using Census data, e.g. renter households in a county or high-income families with children in a state. Returns the strongest defensible result available: an official Census estimate or a direct ACS PUMS survey estimate with a 90% margin of error. Custom criteria combinations work for states, PUMAs and counties made of whole PUMAs. Unsupported requests are refused and not charged. Not endorsed by the U.S. Census Bureau.","last_updated":"2026-09-25T21:35:23.519Z","schemes":["exact"]}