US Site Selection
Rank U.S. locations using buyer-defined Census and economic criteria, including demographics, housing, jobs, wages, GDP, employer activity, industry specialization and optional target-market sizing. Scores are transparent and based only on the criteria and weights supplied.
Offering
- Provider
- agent-vending-production.up.railway.app
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Location And Travel
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://agent-vending-production.up.railway.app/v1/site-selection- MIME type
- Not provided
- First seen
- 2026-10-16T01:51:02.144Z
- Last seen
- Tags
- site selection, location ranking, market selection, Census data, ACS
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"payTo": "0x0b4242adf40726d9b09688030948176752d29924"
}
]Observed health
- Status
- Reachable
- Latest latency
- 125 ms
- Average latency
- 399 ms
- HTTP status
- 405
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"body": {
"criteria": [
{
"metric": "median_household_income",
"preference": "higher"
},
{
"metric": "average_annual_pay",
"preference": "lower"
},
{
"metric": "qcew_employment_growth_5y",
"preference": "higher"
},
{
"metric": "laus_unemployment_rate",
"preference": "lower"
},
{
"metric": "employer_establishments_per_1000_residents",
"preference": "higher"
}
],
"data_scope": "census_and_economy",
"locations": [
"Ventura County, CA",
"Orange County, CA",
"San Diego County, CA"
],
"mode": "candidate"
},
"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,
"description": "One of candidates/locations or search. data_scope \"census\" (default) = 1.0 behavior; \"census_and_economy\" = counties, Census + economic metrics, 2023-aligned scoring.",
"examples": [
{
"criteria": [
{
"metric": "median_household_income",
"preference": "higher"
},
{
"metric": "average_annual_pay",
"preference": "lower"
},
{
"metric": "qcew_employment_growth_5y",
"preference": "higher"
},
{
"metric": "laus_unemployment_rate",
"preference": "lower"
},
{
"metric": "employer_establishments_per_1000_residents",
"preference": "higher"
}
],
"data_scope": "census_and_economy",
"locations": [
"Ventura County, CA",
"Orange County, CA",
"San Diego County, CA"
],
"mode": "candidate"
},
{
"criteria": [
{
"metric": "target_sector_location_quotient",
"preference": "higher",
"weight": 2
},
{
"metric": "bachelors_or_higher",
"preference": "higher"
},
{
"metric": "average_annual_pay",
"preference": "lower"
}
],
"data_scope": "census_and_economy",
"filters": [
{
"metric": "laus_unemployment_rate",
"operator": "<=",
"value": 6
}
],
"mode": "search",
"search": {
"state": "CA"
},
"target_industry": {
"naics_sector": "54"
},
"top_n": 10
}
],
"properties": {
"balance_categories": {
"description": "Default true",
"type": "boolean"
},
"candidates": {
"items": {
"additionalProperties": true,
"description": "A U.S. state, county, place or ZCTA by name or GEOID (all candidates must share one type).",
"properties": {
"geoid": {
"description": "Census GEOID (alternative to name)",
"type": "string"
},
"name": {
"description": "e.g. \"Ventura County\", \"Thousand Oaks\", \"91362\", \"CA\"",
"type": "string"
},
"state": {
"description": "State name, postal code or FIPS (county/place by name)",
"type": "string"
},
"type": {
"enum": [
"state",
"county",
"place",
"zcta"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"maxItems": 25,
"minItems": 2,
"type": "array"
},
"category_weights": {
"additionalProperties": {
"exclusiveMinimum": 0,
"type": "number"
},
"description": "Optional weight per active category (DEMOGRAPHICS, INCOME, HOUSING, WORKFORCE, EDUCATION, HEALTH_COVERAGE, TARGET_MARKET); normalized to 1",
"type": "object"
},
"criteria": {
"items": {
"additionalProperties": false,
"properties": {
"metric": {
"enum": [
"population",
"median_age",
"median_household_income",
"per_capita_income",
"poverty_rate",
"unemployment_rate",
"labor_force_participation",
"bachelors_or_higher",
"high_school_or_higher",
"homeownership_rate",
"median_home_value",
"median_gross_rent",
"uninsured_rate",
"foreign_born_rate",
"under_18_rate",
"age_65_plus_rate",
"laus_unemployment_rate",
"labor_force",
"employed_people",
"qcew_employment",
"qcew_employment_growth_1y",
"qcew_employment_growth_3y",
"qcew_employment_growth_5y",
"average_annual_pay",
"average_weekly_wage",
"wage_growth_1y",
"wage_growth_3y",
"wage_growth_5y",
"real_gdp",
"nominal_gdp",
"real_gdp_per_capita",
"nominal_gdp_per_capita",
"real_gdp_growth_1y",
"real_gdp_growth_5y",
"personal_income",
"per_capita_personal_income",
"per_capita_personal_income_growth_1y",
"per_capita_personal_income_growth_5y",
"employer_establishments",
"employer_establishments_per_1000_residents",
"establishment_growth_1y",
"establishment_growth_5y",
"annual_payroll",
"target_sector_location_quotient",
"target_sector_employment_share",
"target_sector_average_pay",
"target_sector_wage_premium"
],
"type": "string"
},
"preference": {
"enum": [
"higher",
"lower"
],
"type": "string"
},
"weight": {
"description": "Default 1",
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"metric",
"preference"
],
"type": "object"
},
"maxItems": 16,
"minItems": 1,
"type": "array"
},
"data_scope": {
"description": "Default \"census\"",
"enum": [
"census",
"census_and_economy"
],
"type": "string"
},
"filters": {
"description": "Optional hard filters applied before ranking",
"items": {
"additionalProperties": false,
"properties": {
"metric": {
"description": "Any criteria metric name",
"type": "string"
},
"operator": {
"enum": [
">=",
"<=",
">",
"<"
],
"type": "string"
},
"value": {
"description": "Percent metrics in percent (5 = 5%)",
"type": "number"
}
},
"required": [
"metric",
"operator",
"value"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"include_latest_context": {
"description": "Not used in SiteScore",
"type": "boolean"
},
"locations": {
"description": "Alias of candidates (\"County, ST\" or FIPS allowed)",
"maxItems": 25,
"minItems": 2,
"type": "array"
},
"mode": {
"enum": [
"candidate",
"search"
],
"type": "string"
},
"percentile_universe": {
"enum": [
"national",
"state"
],
"type": "string"
},
"scoring_reference_period": {
"enum": [
"2023"
],
"type": "string"
},
"search": {
"additionalProperties": false,
"properties": {
"geography_type": {
"description": "census_and_economy: county only",
"enum": [
"state",
"county",
"place",
"zcta"
],
"type": "string"
},
"min_population": {
"description": "places >= 10,000; ZCTAs >= 5,000",
"type": "number"
},
"state": {
"description": "county/place searches only",
"type": "string"
}
},
"required": [],
"type": "object"
},
"target_industry": {
"properties": {
"naics_sector": {
"type": "string"
}
},
"type": "object"
},
"target_market": {
"description": "Optional (CANDIDATE mode, <= 10 candidates): Market Size household criteria, use \"supplemental\" (default) or \"scoring\"",
"properties": {
"filters": {
"type": "array"
},
"preference": {
"enum": [
"higher",
"lower"
],
"type": "string"
},
"unit": {
"enum": [
"household"
],
"type": "string"
},
"use": {
"enum": [
"supplemental",
"scoring"
],
"type": "string"
},
"weight": {
"type": "number"
}
},
"type": "object"
},
"top_n": {
"description": "SEARCH mode; default 10",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"vintage": {
"enum": [
"ACS 2023 5-Year"
],
"type": "string"
}
},
"required": [
"criteria"
],
"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 = completed ranking (charged). Refusals/errors are never charged (400/422/5xx, charged=false), incl. incompatible data scope, redundant criteria, research-only metrics, invalid NAICS sector, SCORING_DATA_INCOMPLETE. SiteScore 0-100 = relative fit under the buyer-supplied criteria and weights; not a probability of success or profitability.",
"properties": {
"category_composition": {
"type": "object"
},
"charged": {
"type": "boolean"
},
"comparison_universe": {
"type": "object"
},
"criteria": {
"type": "array"
},
"data_scope": {
"type": "string"
},
"data_vintage": {
"type": "object"
},
"economic_provenance": {
"type": "object"
},
"eligibility": {
"type": "object"
},
"eligible_locations": {
"type": "integer"
},
"error": {
"type": "object"
},
"methodology": {
"type": "object"
},
"mode": {
"type": "string"
},
"provenance": {
"type": "array"
},
"results": {
"type": "array"
},
"scoring_reference_period": {
"type": "integer"
},
"site_selection_version": {
"type": "string"
},
"status": {
"type": "string"
},
"target_industry": {
"type": "object"
},
"target_market": {
"type": "object"
},
"warnings": {
"type": "array"
}
},
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}