{"uid":"cap_C0eH-wMbBKQELJNryd_xY","slug":"interzoid-get-nearest-coffee-shops-449808de","name":"Interzoid Get Nearest Coffee Shops","description":"Find nearest coffee shops to a given address or location including names, addresses, distances, and basic details.","url":"https://api.interzoid.com/getnearestcoffeeshops","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":["lookup"],"properties":{"lookup":{"type":"string","description":"Reference address or location to find coffee shops near"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"Code":"Success","Shops":"Sightglass Coffee (0.3 mi), Blue Bottle Coffee (0.4 mi), Philz Coffee (0.5 mi)","Origin":"201 Spear St, San Francisco CA","Credits":"0"}},"example":{"request":{"input":{"type":"http","method":"GET","output":{"type":"application/json"},"queryParams":{"lookup":"201 Spear St, San Francisco, CA"}}},"response":{"Code":"Success","Credits":"0","Shop1Name":"Spro Coffee Lab (formerly Starbucks)","Shop2Name":"Peet's Coffee","Shop3Name":"Bluestone Lane Avery Café","Shop1Hours":"Mon–Fri: 4:30 AM–5:30 PM, Sat: 6:00 AM–2:00 PM, Sun: Closed (prior Starbucks hours; Spro Coffee Lab hours TBD)","Shop2Hours":"","Shop3Hours":"Mon–Sun: 7:00 AM–5:00 PM","Shop1Rating":"3.6/5 (TripAdvisor, as prior Starbucks location)","Shop2Rating":"","Shop3Rating":"4.1/5","Shop1Address":"201 Spear St, Ste 100, San Francisco, CA 94105","Shop2Address":"121 Spear St, San Francisco, CA 94105","Shop3Address":"420 Folsom St, San Francisco, CA 94105","Shop1Distance":"0.0 miles (on-site)","Shop2Distance":"~0.1 miles","Shop3Distance":"~0.3 miles","SearchLocation":"201 Spear St, San Francisco, CA 94105"}},"exampleRequest":{"lookup":"201 Spear St, San Francisco, CA"},"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_91xZAmsc3deiAZyT8CD2n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of the nearest coffee shops to a given address or location reference","exampleAgentPrompt":"What coffee shops are nearest to 201 Spear St, San Francisco, CA? I want to know the names and how far away each one is.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a success code, a comma-separated list of nearby coffee shops with their distances in miles, and the resolved origin address used for the lookup.","failureModes":["Invalid or unrecognized address returns an error code","Missing required 'lookup' query parameter returns a 400-style error","Address too ambiguous to resolve returns no results or error","Insufficient credits returns a credits exhausted error"],"whenToPreferThis":"Use this endpoint when you need to programmatically find coffee shops near a specific address or location string, particularly within an automated workflow, CRM enrichment, or data pipeline context. Prefer this over general-purpose mapping APIs when you want a simple, pay-per-call enrichment with no API key setup beyond x402 payment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:45.862Z","isFirstParty":false}