{"uid":"cap_lvn7EyVV24CVNct-DT087","slug":"jp-local-pack-api-houjin-lookup-by-name-8cd62510","name":"JP Local Pack API — Houjin Lookup by Name","description":"Japan payroll / tax / social insurance / mynumber / corporate / invoice / holiday reference API for AI agents. x402 micropayments on Base. No API key.","url":"https://jp-local-pack-api.kasanegi123.workers.dev/api/houjin-lookup/by-name","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"_role":"shape_preview_echoes_query_for_paid_response","count":0,"query":{"name":"<company keyword>","pref":null,"limit":5},"candidates":[{"name":"<paid response returns Japanese legal name matching the requested name>","name_en":"<English name if registered>","industries":[],"company_url":"<company_url if registered>","match_reason":"<human-readable explanation of the score>","houjin_number":"<13-digit (paid response)>","location_postal":"<postal code>","location_address":"<full address>","match_reliability":0,"match_reliability_label":"<high|medium|low>"}],"attribution":"Source: METI gBizINFO (https://info.gbiz.go.jp).","_sample_note":"Unpaid 402 shape preview echoes the requested name + limit + pref; paid 200 queries gBizINFO live and returns ranked candidates with match_reliability.","_coverage_note":"match_reliability (numeric 0.0-1.0; see match_reliability_label for the human-readable bucket) combines gBizINFO legal-name overlap, curated brand-alias canonical-form matches, and HQ-likelihood signals. High means canonical exact or explicit brand-alias resolution (typically 0.95+); medium means substring overlap that still needs candidate review; low means weak, short, or ambiguous keyword overlap. Always verify the returned houjin_number against /api/houjin-number/lookup for authoritative profile.","_shape_preview_note":"Numeric fields in this unpaid 402 shape preview are 0 placeholders. Real values require X-PAYMENT on production."},"mimeType":"application/json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_ekoYJUi23SEvehuc6glHB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for Japanese legal entities by company name keyword, returning ranked candidates with houjin numbers, addresses, and match reliability scores from METI gBizINFO","exampleAgentPrompt":"Can you look up the official houjin number and registered address for Toyota — search by name keyword 'トヨタ' and return up to 5 candidates with their match reliability?","exampleUseCases":null,"resultDescription":"A JSON object containing a count of candidates, the echoed query parameters, and an array of ranked company candidates each with: Japanese legal name, English name, 13-digit houjin number, postal code, full address, company URL, industry list, match reliability score (0.0–1.0), and a human-readable reliability label (high/medium/low). Attribution to METI gBizINFO is included. High reliability means exact or brand-alias match; medium means substring overlap; low means ambiguous match requiring further verification.","failureModes":["402 Payment Required — no X-PAYMENT header provided, returns shape preview with placeholder zeros instead of real data","Empty candidates array — no matching companies found for the given name keyword","Low match reliability results — keyword is too short or ambiguous, returns weak candidates that need manual review","Prefecture filter mismatch — valid pref code but no companies in that prefecture match the keyword","Rate limiting or worker timeout on Cloudflare edge — transient 5xx error"],"whenToPreferThis":"Use this endpoint when you need to resolve a Japanese company name to its official 13-digit houjin (corporate) number and legal registration details, particularly for invoicing, KYC, supplier onboarding, or tax compliance workflows in Japan. Prefer this over generic web search when you need structured, authoritative data sourced directly from METI gBizINFO with ranked match reliability. Use the /api/houjin-number/lookup sibling endpoint afterward to fetch the full authoritative profile once you have a candidate houjin number.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:35.086Z","isFirstParty":false}