{"slug":"agent-vending-production-up-railway-app-v1-site-selection-94b44c","title":"Rank U.S","host":"agent-vending-production.up.railway.app","method":"POST","resource":"https://agent-vending-production.up.railway.app/v1/site-selection","category":"market","description":"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.","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1381,"reported_calls_30d":3,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"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"},"history":[{"day":"2026-09-27","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":1381,"error":null}],"description_full":"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.","last_updated":"2026-09-27T04:40:16.048Z","schemes":["exact"]}