{"uid":"cap_LKBZPOdO1FsaTFGpEOCSd","slug":"us-site-selection-b7cecdb0","name":"US Site Selection","description":"Pay-per-call machine utilities for autonomous agents.","url":"https://agent-vending-production.up.railway.app/v1/site-selection?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["candidate","search"],"type":"string"},"top_n":{"type":"integer","maximum":25,"minimum":1,"description":"SEARCH mode; default 10"},"search":{"type":"object","required":[],"properties":{"state":{"type":"string","description":"county/place searches only"},"geography_type":{"enum":["state","county","place","zcta"],"type":"string","description":"census_and_economy: county only"},"min_population":{"type":"number","description":"places >= 10,000; ZCTAs >= 5,000"}},"additionalProperties":false},"filters":{"type":"array","items":{"type":"object","required":["metric","operator","value"],"properties":{"value":{"type":"number","description":"Percent metrics in percent (5 = 5%)"},"metric":{"type":"string","description":"Any criteria metric name"},"operator":{"enum":[">=","<=",">","<"],"type":"string"}},"additionalProperties":false},"maxItems":10,"description":"Optional hard filters applied before ranking"},"vintage":{"enum":["ACS 2023 5-Year"],"type":"string"},"criteria":{"type":"array","items":{"type":"object","required":["metric","preference"],"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"},"weight":{"type":"number","description":"Default 1","exclusiveMinimum":0},"preference":{"enum":["higher","lower"],"type":"string"}},"additionalProperties":false},"maxItems":16,"minItems":1},"locations":{"type":"array","maxItems":25,"minItems":2,"description":"Alias of candidates (\"County, ST\" or FIPS allowed)"},"candidates":{"type":"array","items":{"type":"object","required":["type"],"properties":{"name":{"type":"string","description":"e.g. \"Ventura County\", \"Thousand Oaks\", \"91362\", \"CA\""},"type":{"enum":["state","county","place","zcta"],"type":"string"},"geoid":{"type":"string","description":"Census GEOID (alternative to name)"},"state":{"type":"string","description":"State name, postal code or FIPS (county/place by name)"}},"description":"A U.S. state, county, place or ZCTA by name or GEOID (all candidates must share one type).","additionalProperties":true},"maxItems":25,"minItems":2},"data_scope":{"enum":["census","census_and_economy"],"type":"string","description":"Default \"census\""},"target_market":{"type":"object","properties":{"use":{"enum":["supplemental","scoring"],"type":"string"},"unit":{"enum":["household"],"type":"string"},"weight":{"type":"number"},"filters":{"type":"array"},"preference":{"enum":["higher","lower"],"type":"string"}},"description":"Optional (CANDIDATE mode, <= 10 candidates): Market Size household criteria, use \"supplemental\" (default) or \"scoring\""},"target_industry":{"type":"object","properties":{"naics_sector":{"type":"string"}}},"category_weights":{"type":"object","description":"Optional weight per active category (DEMOGRAPHICS, INCOME, HOUSING, WORKFORCE, EDUCATION, HEALTH_COVERAGE, TARGET_MARKET); normalized to 1","additionalProperties":{"type":"number","exclusiveMinimum":0}},"balance_categories":{"type":"boolean","description":"Default true"},"percentile_universe":{"enum":["national","state"],"type":"string"},"include_latest_context":{"type":"boolean","description":"Not used in SiteScore"},"scoring_reference_period":{"enum":["2023"],"type":"string"}}},"responseSchema":{"type":"json","example":{"mode":"CANDIDATE","status":"OK","results":[{"rank":1,"metrics":{"average_annual_pay":{"value":77892,"percentile":97.09,"contribution":0.728,"reference_period":"2023"}},"geography":{"name":"Orange County, California","geoid":"06059","geo_type":"county"},"site_score":59.73,"close_score":false,"explanation":["Ranked #1 under supplied criteria (SiteScore 59.73 of 100)."],"category_scores":{"WAGES":2.91,"REGIONAL_INCOME":98.03,"BUSINESS_ACTIVITY":89.67,"LOCAL_LABOR_MARKET":48.3},"category_contributions":{"WAGES":0.728,"REGIONAL_INCOME":24.507,"BUSINESS_ACTIVITY":22.4185,"LOCAL_LABOR_MARKET":12.0741}}],"data_scope":"census_and_economy","methodology":{"score_meaning":"Relative fit under the buyer's supplied criteria and weights."},"site_selection_version":"2.0","scoring_reference_period":2023}},"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_dYfsU3CEMzHIS_wNZIihK","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":"Rank and score U.S. geographic locations (states, counties, places, or ZCTAs) against buyer-defined Census and economic criteria with transparent weighting.","exampleAgentPrompt":"Using Census and economic data, rank the top 10 U.S. counties in Texas by a mix of wage growth over 3 years, labor force participation, and median household income — weight wage growth highest, and only include counties with population over 50,000.","exampleUseCases":[{"title":"Manufacturing plant site search","prompt":"I need to find the best 10 U.S. counties to build a new manufacturing facility — rank them by QCEW employment growth over 5 years, average annual pay, and labor force size, with a hard filter of at least 25,000 employed people. Limit the search to Midwest states."},{"title":"Retail expansion market scoring","prompt":"Score all U.S. places with at least 10,000 people on median household income, population growth, and low poverty rate — weight income the most — and give me the top 15 results so I can prioritize where to open new retail stores."},{"title":"Remote workforce hub identification","prompt":"Find the top 10 U.S. ZIP codes where I should recruit remote workers — rank by bachelor's degree attainment rate, median household income, and homeownership rate, with a minimum population of 5,000, and prefer higher education levels above all else."}],"resultDescription":"A ranked list of up to 25 U.S. geographic locations with composite scores and per-metric breakdowns, filtered by any hard constraints supplied, ordered from best to worst match against the caller-defined criteria and weights.","failureModes":["Invalid or unsupported metric name returns a validation error","Geography type incompatible with selected data source (e.g. census_and_economy requires county) returns an error","Filters that eliminate all candidates return an empty result set","top_n exceeding 25 is rejected","Missing required criteria array may return unranked or error response","Unsupported state abbreviation or geography scope combination returns an error"],"whenToPreferThis":"Use this endpoint when you need to objectively rank multiple U.S. locations against a custom set of economic, demographic, labor, or housing metrics with user-defined importance weights. It is ideal for site selection, market entry analysis, workforce hub identification, or any decision requiring transparent, criteria-based geographic scoring rather than raw data lookup or simple filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:34:48.298Z","isFirstParty":false,"canonicalSlug":"us-site-selection-b7cecdb0"}