{"uid":"cap_9eszcyYFQFrLNiYxmjqp_","slug":"local-business-leads-api-cb59862e","name":"Local Business Leads API","description":"Find local businesses by city and category. Returns name, phone, address and verified website status (live/broken/none, https, last-checked date). 0.05 USDC per query.","url":"https://local-leads-api.vercel.app/api/v1/leads?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["city","category"],"properties":{"city":{"type":"string","maxLength":80,"minLength":2,"description":"US city name, e.g. \"Atlanta\" or \"Jonesboro\"."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Max results to return (1-50, default 25)."},"state":{"type":"string","maxLength":40,"minLength":2,"description":"US state code or name (e.g. \"GA\"). Recommended: without it, the state where the city has the most listings is used."},"category":{"type":"string","maxLength":40,"minLength":2,"description":"Business category. One of: plumber, roofer, electrician, hvac, dentist, doctor, chiropractor, veterinarian, lawyer, accountant, insurance_agent, real_estate_agent, auto_repair, hair_salon, beauty_salon, locksmith, landscaper, carpenter, painter, restaurant, cafe, pharmacy, gym. Common plurals/synonyms are accepted."},"require_phone":{"enum":["true","false"],"type":"string","description":"If \"true\", only return businesses that have a phone number."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["query","count","total_available","privacy_mode","results","generated_at","data_release","notice","attribution"],"properties":{"count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"query":{"type":"object","required":["city","state","category","resolved_location"],"properties":{"city":{"type":"string"},"state":{"type":"string"},"category":{"type":"string"},"resolved_location":{"type":"string"}},"additionalProperties":false},"notice":{"type":"string","description":"Terms of Use link, required lawful-contact practices, and the removal-request email."},"results":{"type":"array","items":{"type":"object","required":["business_name","phone","address","website","website_status","website_https","website_checked_at","email","latitude","longitude","confidence","source_id"],"properties":{"email":{"type":["string","null"],"description":"Business email when listed. Personal webmail addresses (gmail, yahoo, etc.) are withheld for privacy."},"phone":{"type":["string","null"]},"address":{"type":"object","required":["formatted","street","city","state","postcode"],"properties":{"city":{"type":["string","null"]},"state":{"type":["string","null"]},"street":{"type":["string","null"]},"postcode":{"type":["string","null"]},"formatted":{"type":["string","null"]}},"additionalProperties":false},"website":{"type":["string","null"]},"latitude":{"type":"number"},"longitude":{"type":"number"},"source_id":{"type":"string"},"confidence":{"type":"number","description":"0-1 existence confidence from the number of sources that agree on this business."},"business_name":{"type":"string"},"website_https":{"type":["boolean","null"],"description":"true = site works on a secure https:// address; false = it only works on insecure http://; null = no website, not working, or not checked yet."},"website_status":{"enum":["live","unreachable","none","unchecked"],"type":"string","description":"From our background checks: \"live\" = site responded; \"unreachable\" = clearly broken (domain no longer exists, connection refused, invalid security certificate, or page and home page both missing/erroring); \"none\" = no website listed; \"unchecked\" = not verified yet (queued, or an earlier check was inconclusive and will be retried within days)."},"website_checked_at":{"type":["string","null"],"description":"When the website was last verified (ISO 8601 UTC). Sites are re-verified every 30 days. null = not checked yet."}},"additionalProperties":false}},"attribution":{"type":"string"},"data_release":{"type":["string","null"]},"generated_at":{"type":"string"},"privacy_mode":{"enum":["standard","strict"],"type":"string","description":"strict = state with a data broker law: only listings with their own business website and no person's name are returned, and emails only on the business's own domain."},"total_available":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"count":1,"query":{"city":"Atlanta","state":"GA","category":"plumber","resolved_location":"Atlanta, GA"},"notice":"Business listings for B2B use under https://local-leads-api.vercel.app/terms. Buyers must follow calling, texting and email laws (e.g. TCPA, Do-Not-Call, CAN-SPAM). Removal requests: localleads.support@gmail.com.","results":[{"email":null,"phone":"+1 (404) 555-0100","address":{"city":"Atlanta","state":"GA","street":"123 Peachtree St NE","postcode":"30303","formatted":"123 Peachtree St NE, Atlanta, GA 30303"},"website":"https://example.com/","latitude":33.7537,"longitude":-84.3863,"source_id":"overture:00000000-0000-0000-0000-000000000000","confidence":0.97,"business_name":"Example Plumbing Co","website_https":true,"website_status":"live","website_checked_at":"2026-10-14T09:00:00.000Z"}],"attribution":"Business data from Overture Maps Foundation (overturemaps.org), release 2026-09-23.1, licensed CDLA-Permissive-2.0; includes data from Foursquare (Apache-2.0) and AllThePlaces (CC0).","data_release":"2026-09-23.1","generated_at":"2026-10-14T00:00:00.000Z","privacy_mode":"standard","total_available":1}},"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_A4ghr1WYqn1NjzhiX2Brk","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":"Returns local business contact data (name, phone, address, website) for a given US city, state, and business category","exampleAgentPrompt":"Can you pull me a list of up to 20 licensed plumbers in Atlanta, GA — I need ones that have a phone number listed?","exampleUseCases":[{"title":"Sales outreach lead list generation","prompt":"I need a list of up to 30 roofing companies in Dallas, TX for a sales outreach campaign — make sure they all have phone numbers so I can call them."},{"title":"Local service finder for home repair","prompt":"Find me electricians in Nashville, Tennessee — give me up to 10 results with their addresses and websites."},{"title":"Competitor research by category","prompt":"Can you get me a list of hair salons in Miami, FL? I want to see up to 25 of them including their websites and contact info."}],"resultDescription":"A JSON object containing a query summary (city, state, category, resolved location), a count of returned results, total available results, a data release timestamp, and an array of business records each containing business name, phone, email, address (street, city, state, postcode, formatted), website URL, website status, geographic coordinates (latitude/longitude), a confidence score, and a source ID. Also includes attribution for the underlying data sources.","failureModes":["Missing required parameters (city or category) returns a 400 error","Unknown or misspelled city name may return zero results or resolve to the wrong location","Category not in the supported enum list may return an error or empty results","Payment not completed via x402 results in a 402 Payment Required response","State omitted may resolve to an unexpected state when the city name is ambiguous","Limit exceeds 50 returns a validation error"],"whenToPreferThis":"Use this endpoint when you need structured local business contact data (phone, address, website) for a specific US city and business category, especially for lead generation, sales outreach, or service discovery. It is a good fit when you need results quickly per query at low per-call cost ($0.05), want data attributed to open licensed sources (Overture, Foursquare, AllThePlaces), and need confidence scores per record. Prefer this over web scraping or general search when you want clean, structured output with geographic coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T08:30:39.472Z","isFirstParty":false,"canonicalSlug":"local-business-leads-api-cb59862e"}