{"uid":"cap_-XDqgAYbEa12uppqido1g","slug":"mois-solo-household-demand-scorer-2d243f09","name":"MOIS Solo Household Demand Scorer","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/mois-solo-household-demand-scorer","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"requestId":{"type":"string","pattern":"^[A-Za-z0-9_-]{8,64}$"},"ageWeights":{"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},"peerLegalCodes":{"type":"array","items":{"type":"string","pattern":"^[0-9]{10}$"},"maxItems":200,"minItems":2,"uniqueItems":true},"targetLegalCodes":{"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":"deprioritize","village":"","vintage":"2026-07-31","ageFacts":[{"maxAge":39,"minAge":20,"weight":1,"households":49}],"district":"종로구","province":"서울특별시","stableId":"MOIS-SOLO:1111010100:2026-07-31:c54dff4186604e43","legalCode":"1111010100","peerCount":4,"neighborhood":"청운동","weightedShare":0.26630435,"soloHouseholds":184,"demandPercentile":33.33,"weightedHouseholds":49}],"source":{"url":"https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000003691861&fileDetailSn=1&insertDataPrcus=N","bytes":9699741,"sha256":"df8ebf47916268be4279ad1cbe4faec1c130dc023e9b5fb40d88ceb1e22e8b5a","retrievedAt":"2026-08-14T06:57:51.456Z"},"country":"KR","product":"mois-solo-household-demand-scorer","vintage":"2026-07-31","baseline":false,"billable":true,"decision":"solo-household territory score batch","stableId":"MOIS-SOLO-BATCH:2026-07-31:c54dff4186604e434cee6f3a","disclaimer":"Aggregate one-person-household territory benchmark; not a forecast or proof of customer demand.","attribution":"Source: Ministry of the Interior and Safety one-person household file via data.go.kr","schemaVersion":"1.0","criteriaSha256":"c54dff4186604e434cee6f3abda7df2ba10cba9211e2b0e5efc14974d9d8a201","sourceRowCount":18624}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BA7IGW7fSgkgsRR-hAKSI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores and ranks Korean administrative neighborhoods by single-person household density and demand percentile using official Ministry of the Interior and Safety data","exampleAgentPrompt":"Score solo household demand for neighborhoods in 종로구, 서울특별시 using the July 2026 vintage, focusing on residents aged 20 to 39, so I can see which territories to prioritize or deprioritize for a single-person household product launch.","exampleUseCases":[{"title":"Studio apartment market targeting in Seoul","prompt":"I'm launching a studio apartment rental platform in Seoul — score all the neighborhoods in 마포구 by single-person household demand using the latest available vintage, for the 25–35 age bracket, so I know which territories to focus on first."},{"title":"Retail site selection for solo-living brand","prompt":"We're opening convenience stores catering to solo households in 서울특별시. Give me the solo household demand percentile scores for 강남구 neighborhoods using the 2026-07-31 vintage data, weighted for ages 20 to 49, so we can rank candidate sites."},{"title":"Public policy territory prioritization","prompt":"For our city planning report, score the one-person household demand across districts in 부산광역시 using the most recent MOIS vintage, for residents aged 65 and older, so we can identify which neighborhoods need the most single-elderly support services."}],"resultDescription":"Returns a batch of neighborhood-level scores including demand percentile (0–100), weighted household share, raw solo household count, peer count, an action recommendation (e.g. 'deprioritize'), and source attribution metadata including SHA-256 hash, retrieval timestamp, and stable IDs for reproducibility — all tied to a specific MOIS data vintage and legal district code.","failureModes":["Invalid or unknown legal code returns empty results set","Requested vintage date not yet available returns no data","Age range outside supported bounds may return zero-weighted results","Malformed request body causes 400 bad request","Payment settlement failure returns 402 payment required","Province/district name mismatch with legal code causes scoring errors"],"whenToPreferThis":"Choose this endpoint when you need official, government-sourced single-person household statistics for Korean administrative neighborhoods, especially when you need reproducible benchmarks tied to a specific data vintage with stable IDs. Prefer this over generic census APIs when you need pre-computed demand percentiles and action recommendations rather than raw counts, or when you need age-weighted scoring for market segmentation in South Korea.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:43.103Z","isFirstParty":false}