{"uid":"cap_h0VUdnlG6SUryRn_rjq6X","slug":"bbb-business-search-scraper-78b4c41f","name":"BBB Business Search Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/bbb?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["Relevance","Rating","Distance","AToZ","ZToA"],"type":"string","default":"Relevance","description":"Order returned by the public search endpoint."},"country":{"enum":["USA","CAN"],"type":"string","default":"USA","description":"Country for keyword searches."},"distance":{"type":"integer","maximum":500,"minimum":1,"description":"Optional distance filter for searches with a location."},"location":{"type":"string","description":"City and state or province for keyword searches. Leave empty for a country-wide search."},"maxItems":{"type":"integer","default":100,"minimum":1,"description":"Maximum unique businesses to save across all searches and URLs."},"startUrls":{"type":"array","description":"Public BBB search URLs or direct business profile URLs. Profile URLs are resolved through search listings."},"searchTerms":{"type":"array","description":"Business categories or keywords to search. Each term is combined with the location."},"accreditedOnly":{"type":"boolean","default":false,"description":"Return only businesses marked as accredited in the search listing."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"name":null,"type":null,"bbbId":null,"bbbRating":null,"businessId":null,"profileUrl":null,"ratingScore":null,"isAccredited":null}],"product":"bbb"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.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_nRPWtJMnCsP_yv6gSc6FJ","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":"Scrapes Better Business Bureau (BBB) business listings and profiles, returning structured business data including ratings, accreditation status, and profile URLs.","exampleAgentPrompt":"Search BBB for accredited electricians in Austin, Texas — sort by Rating, limit to 50 results, and give me each business's name, BBB rating, and profile URL.","exampleUseCases":[{"title":"Vetting local contractors before hiring","prompt":"Can you pull up to 30 BBB-accredited roofing companies in Denver, Colorado, sorted by Rating? I want their names, BBB ratings, and profile URLs so I can vet them before getting quotes."},{"title":"Competitor research for a local market","prompt":"Search BBB for all pest control businesses in Miami, Florida — no accreditation filter, sort by Relevance, up to 100 results — I need the full list with BBB IDs and rating scores for a market analysis."},{"title":"Building a vetted vendor directory","prompt":"Find BBB-listed plumbers within 25 miles of Seattle, WA, accredited only, sorted by Rating, max 50 — I'm building a recommended vendor list and need their names, BBB ratings, and profile URLs."}],"resultDescription":"Returns a JSON object with a count of results and an array of business items, each containing: business name, type, BBB ID, BBB rating, business ID, profile URL, rating score, and accreditation status. Failed or empty runs are not charged.","failureModes":["No results found for the given search terms and location — endpoint returns empty items array (not charged)","Invalid or unreachable BBB URLs in startUrls — scrape fails silently or returns partial data","Rate limiting or blocking by BBB — may return empty or partial results","Invalid enum value for sort or country fields — request rejected with validation error","Location not recognized by BBB — may return zero results"],"whenToPreferThis":"Use this endpoint when you need structured BBB business data — ratings, accreditation status, and profiles — for businesses in the USA or Canada. Prefer this over manual BBB browsing or generic web scrapers when you need clean, normalized business records with BBB-specific fields like bbbRating and isAccredited. Especially useful for building vendor lists, due-diligence checks, or competitive research on local businesses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:19.491Z","isFirstParty":false,"canonicalSlug":"bbb-business-search-scraper-78b4c41f"}