{"uid":"cap_rc2RB0rsEC_JXWeAlsjBM","slug":"postcode-context-uk-compare-2-5-postcodes-25bda0d9","name":"Postcode Context UK – Compare 2–5 Postcodes","description":"POST /api/v1/compare — Multi-Postcode Comparative Demographic Synthesis (2 to 5 postcodes side-by-side comparative analysis and affluence ranking)","url":"https://api.postcodecontext.uk/api/v1/compare?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["postcodes"],"properties":{"postcodes":{"type":"string","default":"SW1A 1AA,BB7 3BB","description":"Comma-separated list of 2 to 5 UK postcodes (e.g. SW1A 1AA,BB7 3BB)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_ECUyfyKvYy2PI8BAmgXlf","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":"Returns a comparative socio-economic and property intelligence synthesis across 2 to 5 UK postcodes in a single call","exampleAgentPrompt":"Can you compare the socio-economic and property profiles of SW1A 1AA, E1 6RF, and N1 9GU and tell me which area looks most prosperous?","exampleUseCases":[{"title":"Retail site selection across UK areas","prompt":"I'm deciding between opening a shop in M1 1AE, LS1 1BA, or B1 1BB — can you compare the demographics and property intelligence for those three postcodes so I can see which area has the strongest customer base?"},{"title":"Residential relocation neighbourhood comparison","prompt":"We're thinking of moving to one of these three areas — SE1 7PB, E2 8DP, or N16 8EJ. Can you compare the socio-economic profiles and property data so we can figure out which neighbourhood suits us best?"},{"title":"Property investment benchmarking","prompt":"I want to benchmark these four postcodes for buy-to-let investment: LS2 9JT, M4 1HN, B5 4TB, and L1 1JJ — compare their property and demographic intelligence and highlight which looks like the best opportunity."}],"resultDescription":"A synthesised comparative report covering socio-economic indicators, property metrics, and demographic characteristics for each of the supplied postcodes, structured to allow direct side-by-side benchmarking of the areas.","failureModes":["Fewer than 2 or more than 5 postcodes supplied — request rejected","Invalid or non-existent UK postcode format — lookup fails for that entry","Payment not processed (x402) — 402 response returned before data is served","Rate limiting or quota exceeded — 429 or equivalent error"],"whenToPreferThis":"Use this endpoint when you need a direct side-by-side socio-economic and property intelligence comparison of between 2 and 5 specific UK postcodes in a single call. Prefer it over single-postcode lookups when the user's goal is relative benchmarking or ranking of areas rather than enriching one location in isolation. For bulk enrichment of more than 5 postcodes without a comparison framing, use the sibling bulk endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T12:30:45.149Z","isFirstParty":false,"canonicalSlug":"postcode-context-uk-compare-2-5-postcodes-25bda0d9"}