{"uid":"cap_Vorp5Swc2eX4WxGSN0fgs","slug":"apple-maps-business-search-scraper-x402-153e08b3","name":"Apple Maps Business Search Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/apple-maps?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"openNow":{"type":"boolean","default":false,"description":"Keep only places open when the run executes, based on published weekly hours and local timezone."},"hasPhone":{"type":"boolean","default":false,"description":"Keep only places with a published phone number."},"language":{"type":"string","default":"en-US","description":"Locale for result text and categories, such as en-US or de-DE."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many places across all inputs. Zero means no total limit."},"minRating":{"enum":["3","3.5","4","4.5"],"type":"string","description":"Keep places whose rating converts to at least this score on a five-point scale."},"placeUrls":{"type":"array","items":{"type":"string"},"description":"Direct Apple Maps place links, including place-id and auid links."},"hasWebsite":{"type":"boolean","default":false,"description":"Keep only places with a published website."},"maxResults":{"type":"integer","default":50,"maximum":500,"minimum":1,"description":"Maximum unique places from each search. Dense searches shift the center to pass the 25-result window."},"searchUrls":{"type":"array","items":{"type":"string"},"description":"Apple Maps search links with query and center coordinates."},"countryCode":{"type":"string","default":"US","description":"Two-letter country context used for place ranking and results."},"searchQueries":{"type":"array","items":{"type":"object","required":["query","location"],"properties":{"query":{"type":"string","title":"Search term","editor":"textfield","description":"Business type or name to search for."},"location":{"type":"string","title":"Location","editor":"textfield","description":"City, neighborhood, or address used as the search center."},"maxResults":{"type":"integer","title":"Maximum results","editor":"number","maximum":500,"minimum":1,"description":"Override the global result limit for this query."}}},"description":"Search businesses by term and location. Each search covers an area around the location."},"includeNearbyPlaces":{"type":"boolean","default":false,"description":"Include additional places returned with the map response outside the ranked list."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"name":null,"phone":null,"placeId":null,"website":null,"placeUrl":null,"placeType":null,"placeIdHex":null,"phoneFormatted":null}],"product":"apple-maps"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5-CTX2mtOL2ldoaxV64_x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Apple Maps for businesses by query, location, or URL and returns structured place data including name, phone, website, and place ID.","exampleAgentPrompt":"Search Apple Maps for Italian restaurants in Chicago with at least a 4-star rating, show me up to 50 results, and only include ones that have a website — give me their names, websites, and phone numbers.","exampleUseCases":[{"title":"Local competitor research for a business","prompt":"Find all nail salons in Austin, TX on Apple Maps with a rating of at least 4 stars and a published website — I need their names, phone numbers, and websites, up to 100 results."},{"title":"Lead generation for a sales team","prompt":"Search Apple Maps for plumbers in the Denver metro area, only ones that are open right now and have a phone number listed, give me up to 200 results."},{"title":"Venue discovery for an event planner","prompt":"Pull up to 50 event venues or banquet halls in Brooklyn, NY from Apple Maps — filter to only those with a website and at least a 3.5-star rating, in English."}],"resultDescription":"Returns a JSON object with a count and an array of place items. Each item includes the business name, phone number (raw and formatted), website URL, Apple Maps place URL, place ID, place ID hex, and place type category. Failed or empty runs are not billed.","failureModes":["Empty results if the query/location combination returns no matching businesses","Apple Maps layout or data changes could break extraction","Invalid or expired Apple Maps URLs in placeUrls or searchUrls return no data","Rate limiting or blocked scraping returns an error without charge","Malformed search queries or unsupported location strings yield zero results"],"whenToPreferThis":"Prefer this endpoint when you need structured business listing data from Apple Maps specifically — including place IDs, Apple Maps URLs, and Apple Maps-native categories — rather than Google Maps or Yelp data. It is especially useful when you need to filter by open-now status, minimum rating, phone availability, or website presence in a single call. The pay-per-successful-call pricing (failed runs are free) makes it low-risk for exploratory queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:44.892Z","isFirstParty":false,"canonicalSlug":"apple-maps-business-search-scraper-x402-153e08b3"}