{"uid":"cap_qFEnhrD0gJKXgKTdgfhfj","slug":"mois-neighborhood-age-demand-scorer-8871dd07","name":"MOIS Neighborhood Age Demand Scorer","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/mois-neighborhood-age-demand-scorer","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"requestId":{"type":"string","pattern":"^[A-Za-z0-9_-]{8,64}$"},"cohortWeights":{"type":"array","items":{"type":"object","required":["minAge","maxAge","weight"],"properties":{"maxAge":{"type":"integer","maximum":110,"minimum":0},"minAge":{"type":"integer","maximum":110,"minimum":0},"weight":{"type":"number","maximum":10,"minimum":0.000001}},"additionalProperties":false},"maxItems":12,"minItems":1},"peerAdminCodes":{"type":"array","items":{"type":"string","pattern":"^[0-9]{10}$"},"maxItems":200,"minItems":2,"uniqueItems":true},"targetAdminCodes":{"type":"array","items":{"type":"string","pattern":"^[0-9]{10}$"},"maxItems":20,"minItems":1,"uniqueItems":true},"maxTotalChargeUsd":{"type":"number","maximum":100,"minimum":0.005}}},"responseSchema":{"type":"json","example":{"meta":{"run_ms":1200,"settled":true,"item_count":1},"results":[{"scores":[{"action":"review","vintage":"2026-06-30","district":"종로구","province":"서울특별시","stableId":"MOIS-AGE:1111051500:2026-06-30:fa9370782dc3ddd0","adminCode":"1111051500","peerCount":4,"cohortFacts":[{"maxAge":39,"minAge":20,"weight":1,"population":2708}],"neighborhood":"청운효자동","weightedShare":0.25351058,"totalPopulation":10682,"demandPercentile":66.67,"weightedPopulation":2708}],"source":{"url":"https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000003669440&fileDetailSn=1&insertDataPrcus=N","bytes":2563714,"sha256":"4d1530f251b312ce6564ba5676093b1043057f46a0fe2a58cf2756afc530da7b","retrievedAt":"2026-08-14T06:55:22.631Z"},"country":"KR","product":"mois-neighborhood-age-demand-scorer","vintage":"2026-06-30","baseline":false,"billable":true,"decision":"cohort demand score batch","stableId":"MOIS-AGE-BATCH:2026-06-30:fa9370782dc3ddd007c366b1","disclaimer":"Aggregate population cohort benchmark; not a forecast or proof of customer demand.","attribution":"Source: Ministry of the Interior and Safety resident-registration population file via data.go.kr","schemaVersion":"1.0","criteriaSha256":"fa9370782dc3ddd007c366b1e4f78b6646755387c69bb30fc1baf7497499ea60","sourceRowCount":3618}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IWiW4PDyk0Tuduf_RmOx8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores South Korean neighborhoods by age-cohort population demand using Ministry of the Interior and Safety resident registration data","exampleAgentPrompt":"Score the 청운효자동 neighborhood in 종로구, Seoul for the 20-39 age cohort using the June 2026 vintage data, and tell me the demand percentile and weighted population share.","exampleUseCases":[{"title":"Korean retail site selection by demographics","prompt":"I'm evaluating neighborhoods in Seoul for a new co-working space targeting 20-39 year-olds. Can you pull the MOIS age demand scores for districts in 종로구 using the 2026 vintage and tell me which neighborhoods rank in the top percentile for that age group?"},{"title":"Market entry demographic validation","prompt":"We're launching a consumer app in South Korea and need to know which Seoul neighborhoods have the strongest concentration of adults aged 20-39. Get me the demand percentile scores by neighborhood from the MOIS population data for June 2026."},{"title":"Urban planning age cohort benchmarking","prompt":"For my urban analytics report, can you pull the cohort demand scores for 청운효자동 in 서울특별시 across the 20-39 age bracket using the June 30 2026 vintage, including the total population and peer count?"}],"resultDescription":"Returns a JSON object with per-neighborhood demand scores including: demand percentile (0-100), weighted population share, weighted and total population counts, cohort facts (min/max age, weight), admin code, stable ID, peer count, data source URL with SHA-256 hash, vintage date, attribution to MOIS resident registration file, and a disclaimer that the score is an aggregate benchmark, not a demand forecast.","failureModes":["Invalid or unknown adminCode returns empty results array","Unsupported vintage date returns no matching data","Malformed age range parameters cause 400-level errors","Data not yet available for requested vintage returns empty or baseline:false result","Network timeout if source file retrieval from data.go.kr is slow"],"whenToPreferThis":"Choose this endpoint when you need granular, official South Korean neighborhood-level demographic demand scores based on resident registration data, particularly for age-cohort segmentation. It is ideal for market sizing, retail site selection, or urban planning in South Korea where authoritative government population data (MOIS) is required. Prefer this over general census APIs when you need demand percentile rankings across peer neighborhoods and stable reproducible IDs tied to a specific vintage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:52:00.929Z","isFirstParty":false}