{"uid":"cap_3dAV2CVwoIzhovN1pWmTt","slug":"bbb-business-search-profile-scraper-acbd801d","name":"BBB Business Search & Profile Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_TE_Bv3qAcGK7Ks9G-25Cv","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":"Searches the Better Business Bureau directory and returns structured business profile data including BBB ratings and accreditation status","exampleAgentPrompt":"Search the BBB directory for accredited plumbers in Chicago, Illinois — sort by Rating and return up to 50 results with their BBB scores and profile URLs.","exampleUseCases":[{"title":"Vetting local contractors before hiring","prompt":"Find me BBB-accredited roofing companies in Austin, Texas — sort results by Rating and give me up to 30 businesses with their BBB scores so I can figure out who's trustworthy."},{"title":"Lead list for B2B sales outreach","prompt":"Pull up to 100 HVAC businesses from the BBB directory in Los Angeles, CA — I don't need accredited only, just sort by Relevance and get me their names, BBB ratings, and profile URLs."},{"title":"Consumer trust research across US market","prompt":"Do a country-wide BBB search for 'personal injury law firms' in the USA with no location filter, sort A to Z, and return up to 100 results including whether each one is accredited."}],"resultDescription":"Returns a JSON object with a count and array of business items, each containing the business name, type, BBB ID, business ID, BBB rating letter grade, numeric rating score, profile URL, and accreditation status. Failed or empty runs are not billed.","failureModes":["No results returned if search terms match no BBB listings — not charged","Invalid enum value for sort or country fields returns a validation error","Distance filter ignored if no location is provided","BBB website structural changes may cause empty or malformed responses","Rate limiting or blocking by BBB may result in empty runs"],"whenToPreferThis":"Use this endpoint when you need structured BBB business data — ratings, accreditation status, and profile details — from keyword or category searches across US or Canadian markets. Prefer this over manual web scraping when you need reliable, pay-only-on-success extraction of BBB directory data at scale, or when validating business trustworthiness by BBB credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:26:26.190Z","isFirstParty":false,"canonicalSlug":"bbb-business-search-profile-scraper-acbd801d"}