{"uid":"cap_pmISBC2gWGYfx9W7MJfR8","slug":"demographic-similarity-43db264b","name":"Demographic Similarity","description":"Pay-per-call machine utilities for autonomous agents.","url":"https://agent-vending-production.up.railway.app/v1/demographic-similarity?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"state":{"type":"string","description":"State for STATE_* universes (default: target state)"},"top_n":{"type":"integer","maximum":25,"minimum":1,"description":"Default 10"},"target":{"type":"object","required":["type"],"properties":{"name":{"type":"string","description":"e.g. \"Ventura County\", \"Thousand Oaks\", \"91362\", \"CA\", tract code"},"type":{"enum":["state","county","place","zcta","tract"],"type":"string"},"geoid":{"type":"string","description":"Census GEOID alternative to name (county 5, place 7, tract 11 digits)"},"state":{"type":"string","description":"State name, postal code or FIPS (county/place/tract by name)"},"county":{"type":"string","description":"County name or FIPS (tract only)"}},"description":"Target county, place or state","additionalProperties":true},"universe":{"enum":["US_COUNTIES","STATE_COUNTIES","US_PLACES_10K","US_PLACES_50K","STATE_PLACES_10K","US_STATES"],"type":"string","description":"Peer universe of the same geography type (default by target type)"}}},"responseSchema":{"type":"json","example":{"method":{"primary":"shrinkage_mahalanobis","shrinkage_intensity":0.003299,"covariance_estimator":"ledoit_wolf_scaled_identity"},"status":"OK","target":{"name":"Ventura County, California","geoid":"06111","geo_type":"county"},"matches":[{"rank":1,"distance":0.967103,"geography":{"name":"Napa County, California","geoid":"06055"},"similarity_score":null,"category_contributions":{"demographics":{"share":0}},"top_difference_contributors":[{"metric":"median_age","match_value":42.8,"target_value":39.4}],"top_similarity_contributors":[{"metric":"foreign_born_pct","match_value":22.1,"target_value":21.9}]},{"rank":2,"distance":1.060634,"geography":{"name":"Orange County, California","geoid":"06059"}}],"product":"demographic_similarity","universe":{"id":"US_COUNTIES","size":3142,"geo_type":"county","self_excluded":true},"uncertainty":{"available":false},"data_vintage":{"label":"ACS 5-Year 2019-2023","dataset":"ACS 5-Year","release_year":2023},"feature_bundle":{"id":"DEMOGRAPHIC_CORE","version":"1.0"}}},"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_sv9Y4KhzE_VuENZkwoBQq","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":"Find the U.S. places most demographically similar to a target geography using multivariate Census statistics.","exampleAgentPrompt":"Find the 10 U.S. counties most demographically similar to Ventura County, California — search across all U.S. counties.","exampleUseCases":[{"title":"Market expansion peer city identification","prompt":"I'm expanding my business and want to find the 10 cities in the U.S. with over 50,000 people most demographically similar to Thousand Oaks, California — can you pull a ranked list?"},{"title":"Policy benchmarking for county government","prompt":"We're doing a benchmarking study for Travis County, Texas — find the 15 most demographically similar counties across the entire U.S. so we can compare policy outcomes."},{"title":"Real estate market comparable geography search","prompt":"Find the 5 U.S. ZIP codes most similar demographically to ZIP code 30318 in Georgia — I want to identify comparable neighborhoods for a real estate analysis."}],"resultDescription":"A ranked list of up to 25 U.S. geographies (counties, places, states, ZCTAs, or tracts) most demographically similar to the target geography, ordered by multivariate Census similarity score. Each result typically includes the geography name, GEOID, and a similarity metric derived from Census demographic variables.","failureModes":["Target geography name not found or ambiguous — requires state disambiguation or GEOID","Universe type mismatch with target geography type (e.g. asking for STATE_COUNTIES with a place target)","Census tract not found without proper state and county context","top_n out of range (must be 1–25)","Invalid state postal code or FIPS code","GEOID format mismatch (county=5 digits, place=7 digits, tract=11 digits)"],"whenToPreferThis":"Use this endpoint when you need to find peer or comparable geographies based on multivariate demographic profiles from Census data. Ideal for market research, site selection benchmarking, policy analysis, or identifying expansion targets. Prefer this over a generic demographic lookup when the core question is 'what places are most like X?' rather than 'what are the demographics of X?'","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:41:02.880Z","isFirstParty":false,"canonicalSlug":"demographic-similarity-43db264b"}