Estimate the size of a U.S
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.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://agent-vending-production.up.railway.app/v1/market-size
| Category | Market data |
|---|---|
| Provider host | agent-vending-production.up.railway.app |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-26 | valid payment request | 402 | $0.01 | 1364 ms |
Example input (from the provider)
{
"body": {
"filters": [
{
"operator": "==",
"value": "renter",
"variable": "tenure"
}
],
"geography": {
"name": "Ventura County",
"state": "CA",
"type": "county"
},
"unit": "household"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$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",