--- type: "firecrawl-provider" description: "bbb.org business directory: search businesses by name/category and location across the US and Canada with rating and accreditation filters; read a full business profile with BBB letter grade, accreditation status and dates, complaint and review summaries, alerts and licences; list published complaints with business responses; resolve a pasted bbb.org URL or id to its canonical identity. Reads the server-rendered page state live on every call; bbb.org sits behind a Cloudflare managed challenge which the runner's solver clears." use_when: "bbb.org business directory: search businesses by name/category and location across the US and Canada with rating and accreditation filters; read a full business profile with BBB letter grade, accreditation status and dates, complaint and review summaries, alerts and licences; list published complaints with business responses; resolve a pasted bbb.org URL or id to its canonical identity. Reads the server-rendered page state live on every call; bbb.org sits behind a Cloudflare managed challenge which the runner's solver clears." categories: "Places" capabilities: 4 credits_per_call: 5 --- # Better Business Bureau on Firecrawl Alexandria bbb.org business directory: search businesses by name/category and location across the US and Canada with rating and accreditation filters; read a full business profile with BBB letter grade, accreditation status and dates, complaint and review summaries, alerts and licences; list published complaints with business responses; resolve a pasted bbb.org URL or id to its canonical identity. Reads the server-rendered page state live on every call; bbb.org sits behind a Cloudflare managed challenge which the runner's solver clears. - Categories: Places - Category index: [Places category](https://firecrawl.dev/alexandria/agents/categories/places) - Provider key: `bbb-org` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/bbb-org) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/bbb-org/openapi.json) ## Capabilities - [Complaints](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/complaints): Published customer complaints for one business from its bbb.org complaints tab, newest first, 10 per page, with complaint type, status, date, text and the business/consumer response thread, plus the status/type filter counts bbb.org offers and the profile's closed-complaint summary. - [Profile](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/profile): The full bbb.org business profile for one business: names, website and phone, categories, BBB letter grade with reasons, accreditation status and dates, file-opened / started / incorporated dates, address and coordinates, entity type, years in business, complaint counts (closed in the last 3 years and 12 months), review count and average stars, alerts such as government actions, licences and management. - [Resolve](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/resolve): Resolve a pasted bbb.org URL (profile or any sub page) or a BBB `id` to the canonical identity: `id`, local BBB id, business id, primary and alternate names, canonical profile / complaints / reviews URLs, city and state, letter grade, accreditation flag and complaints closed in the last 3 years. - [Search](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/search): Find businesses on bbb.org by name or category words and an optional city/state or postal code, with the site's own filters (accredited only, minimum letter grade, category id, state, radius) and sort. Returns 15 items per page with BBB identity, canonical profile URL, letter grade, accreditation flag, categories, address, phones and service areas, plus the filter values bbb.org offers. ## 1. Choose this provider when bbb.org business directory: search businesses by name/category and location across the US and Canada with rating and accreditation filters; read a full business profile with BBB letter grade, accreditation status and dates, complaint and review summaries, alerts and licences; list published complaints with business responses; resolve a pasted bbb.org URL or id to its canonical identity. Reads the server-rendered page state live on every call; bbb.org sits behind a Cloudflare managed challenge which the runner's solver clears. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "bbb-org", "capability": "businesses/complaints", "options": { "id": "1296-7039385" } } ``` ## 3. Add provider options Use only the options needed for the task: - `complaint_type` (string): bbb.org complaint type slug (see `available_filters.type` of a previous page). Example: `productissues` - `id` (string): BBB identity `-` as it appears at the end of the profile URL (e.g. 0825-1000223803). Pattern: ^[0-9]{4}-[0-9]{1,12}$. Example: `-` - `page` (number): 1-based page of 10 complaints, newest first. Example: `1` - `status` (string): bbb.org complaint status filter. Example: `answered` - `url` (string): A pasted bbb.org business profile URL, or any of its sub pages (/complaints, /customer-reviews, /leave-a-review). Exactly one of `id` or `url`. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "bbb-org", capability: "businesses/complaints", options: { id: "1296-7039385", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "bbb-org", "capability": "businesses/complaints", "options": { "id": "1296-7039385" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "bbb-org", "capability": "businesses/complaints", "options": { "id": "1296-7039385" } } }' ``` ### CLI ```sh firecrawl scrape 'bbb-org/businesses/complaints' \ --options '{"id":"1296-7039385"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "bbb-org", "capability": "businesses/complaints", "options": { "id": "1296-7039385" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "bbb-org", "capability": "businesses/complaints", "options": { "id": "1296-7039385" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "attribution": "Better Business Bureau (bbb.org)", "available_filters": { "status": [ { "count": 48783, "slug": "answered" }, { "count": 11967, "slug": "resolved" } ], "type": [ { "count": 26090, "slug": "productissues" }, { "count": 13768, "slug": "serviceorrepair" }, { "count": 9375, "slug": "delivery" } ] }, "bbb_id": "1296", "business_id": "7039385", "complaints_summary": { "closed_last_12_months": 18470, "closed_last_3_years": 60750, "total_displayed": 10000, "unit": "complaints" }, "count": 10, "hidden_count": 1156, "id": "1296-7039385", "items": [ { "date": "2026-09-10", "id": "1296_7039385_25260612", "responses": [ { "author": "business", "date": "2026-09-12", "id": "1296_7039385_25260612_0", "text_html": "Hello,

I'm Naveen from Amazon.com. I'm writing in response to a complaint filed on your behalf by the Better Business Bureau BBB - I've provided the BBB with a copy of this message.

I'm very sorry to hear about the frustrating experience that you've had recently with our team regarding your order ID # *******************. I can certainly understand your request and upon checking, I see that refund of $32.06 was issued on September 11, 2026.

Thanks for your patience and understanding in this regard." }, { "author": "consumer", "date": "2026-09-12", "id": "1296_7039385_25260612_1", "text_html": " 
Hi BBB, 

I'm satisfied with the business's resolution to complaint ID ********.  

Thank you.

******* ****" } ], "status": "Resolved", "text": "Hello,I'm reaching out to escalate a ridiculous runaround I've been getting regarding a $32.06 refund credit that was explicitly promised to me for order #***-4226310-7460223.Two different Amazon support agents put their commitment in writing and confirmed the credit. But instead of honoring what your staff promised, your social media and email teams have completely ignored the proof, claimed it's a \"misunderstanding,\" and started spamming me with blind, automated scripts asking for info I've already provided multiple times. One of the agents even told me that the refund was issued and sent a confirmation email but it never arrived into my account balance.I have attached the screenshots proving the promised credit, the agent saying they issued the credit, and me being denied the refund I was promised. Please issue the $32.06 refund that was promised to my account gift card balance.", "type": "Product Issues" }, { "date": "2026-09-10", "id": "1296_7039385_25258985", "responses": [ { "author": "business", "date": "2026-09-11", "id": "1296_7039385_25258985_0", "text_html": "

Hello,

I'm ********* from Amazon.com. I'm writing in response to a complaint filed on your behalf by the Better Business Bureau BBB - I've provided the BBB with a copy of this message.

I'm sorry for the inconvenience you've experienced with regard to order refund.

Upon review, we see a refund has been issued on the order for $49.38 to your Amazon Gift Card balance on September 10, 2026. You can view your balance and usage history in Your Account here:

*************************************************

Thank you for your patience and understanding in this regard.

Regards,

*********

" }, { "author": "consumer", "date": "2026-09-11", "id": "1296_7039385_25258985_1", "text_html": " 
Hi BBB, 

I'm satisfied with the business's resolution to complaint ID ********.  However, they would not do anything without BBB's intervention so to say business these days are infringing on consumer rights and they are pushing their limits. Thank you for being around to help.

Thank you.
PL" } ], "status": "Resolved", "text": "I am filing this complaint regarding an unresolved refund for a returned item that Amazon's own tracking system confirms they received on September 4, 2026. Despite multiple contacts, I have not received my refund, and I have been given ***eated, inconsistent timelines with no resolution.Details:Order number: [111-3424847-0901051 Item: ******* Pro Rubber Hot Water Garden Hose 5/8\" x 50'Reason for return: The item was defective it broke after approximately 2 days of normal use. Connector crimp was not proper so connector become broken after initial ******** item was returned: Sept 1st, 2026 Date Amazon confirms receipt: September 4, 2026 (per Amazon's own tracking/system status)Refund status as of today: Not issued Contact history:I have contacted Amazon customer service 4 times regarding this issue with no resolution:Aug 27 Chat session. Representative requested photos of damaged item, I updated it. They initiated refund on my behalf, ***orted quality issue Sep 4 Chat session. Chat session whent idle and I disconnected Sep 4 Phone call. Was told 5 - 7 days for refund Sep 10 Phone call. Told to wait for refund to process, *** disconnected the call dispite requested for further support.Each contact has resulted in the same response a request to wait an additional 5-7 days despite the fact that Amazon's system already confirms receipt of the returned item. I am well within, and in fact past, the timeframe I was originally quoted.What I am requesting:I am requesting that Amazon process my refund of $49.38 immediately, given that they have had the returned item in their possession since September 4, 2026, and I have already fulfilled my obligation as a customer by returning the defective item promptly.", "type": "Product Issues" }, { "date": "2026-09-09", "id": "1296_7039385_25257842", "responses": [ { "author": "business", "date": "2026-09-11", "id": "1296_7039385_25257842_0", "text_html": "Hello *****,

I'm ******* from Amazon.com and I'm writing in response to a complaint filed on your behalf by the Better Business Bureau BBB - I've provided the BBB with a copy of this message.

I understand you're looking for prepaid label to return the damaged printer.

As the order is shipped and sold by third party seller, KOMHOW DTF Printer, we do not have option to provide prepaid label. Hence, in this case, as informed by the Guarantee team.

Please return the order to the seller at the following address:
-- Return merchandise authorization (RMA) number, if applicable
-- Return address *****-KRESTRICTED:PHONE_NUMBER , *******************************************
****************, ** RESTRICTED:PHONE_NUMBER US

We recommend following these best practices to be sure that the seller receives your package:
-- Include the order number and any return authorization number on or inside the package.
-- Insure the package.
-- Use signature confirmation.
-- Provide your return tracking number and ship receipt to the seller.
-- Ship items via **** when the seller's return address is a PO Box.

Return shipping will be refunded for damaged or defective items and may be covered for other reasons once the return is delivered to the seller. Please share the ship receipt of your return to get a refund for your return costs. To learn more about return shipping, go to \"A-to-z Guarantee\":
************************************************************************************************************

We appreciate your understanding.

Regards,
*******
Amazon.com
*****************************" }, { "author": "consumer", "date": "2026-09-11", "id": "1296_7039385_25257842_1", "text_html": "I don't have 1500 to sell it back, I paid almost two thousand dollars for this thing. If they're gonna supposedly reimburse me, they can pay for a prepaid label. If I knew what was going to be like this, I wouldn't even let any robotic. But, I mean, I can send you pictures of everything that it does. That is, you know I won't do, but I don't have that kind of money just to send it back.

" } ], "status": "Answered", "text": "I got this in July, 2026. It is damaged it wont go to my computer right. we did a print test gives me nothing but ink on paper. make a lound sound. It dosent work right. **** wont it a prepaid lable to send it back and get my money back. Thats all iv been asking for been alot of game playing with them.", "type": "Service or Repair Issues" } ], "name": "Amazon.com", "next_page": 2, "observed_at_ms": 1789483200000, "page": 1, "page_size": 10, "profile_url": "https://www.bbb.org/us/wa/seattle/profile/ecommerce/amazoncom-1296-7039385", "source_url": "https://www.bbb.org/us/wa/seattle/profile/ecommerce/amazoncom-1296-7039385/complaints?page=1", "status_filter": null, "terms_url": "https://www.bbb.org/terms-of-use", "total_found": 10000, "total_found_note": "bbb.org caps numFound at 10000; use complaints_summary for exact closed counts", "type_filter": null } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Complaints - Capability: `businesses/complaints` - Description: Published customer complaints for one business from its bbb.org complaints tab, newest first, 10 per page, with complaint type, status, date, text and the business/consumer response thread, plus the status/type filter counts bbb.org offers and the profile's closed-complaint summary. - Instructions: You need the complaint detail behind a business's complaint counts, filtered by status (answered, resolved, unanswered) or type. - Cost: 5 credits per call - Capability file: [Complaints](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/complaints) Accepted options: - `complaint_type` (string): bbb.org complaint type slug (see `available_filters.type` of a previous page). Example: `productissues` - `id` (string): BBB identity `-` as it appears at the end of the profile URL (e.g. 0825-1000223803). Pattern: ^[0-9]{4}-[0-9]{1,12}$. Example: `-` - `page` (number): 1-based page of 10 complaints, newest first. Example: `1` - `status` (string): bbb.org complaint status filter. Example: `answered` - `url` (string): A pasted bbb.org business profile URL, or any of its sub pages (/complaints, /customer-reviews, /leave-a-review). Exactly one of `id` or `url`. Example: `` Response schema example: ```json { "attribution": "Better Business Bureau (bbb.org)", "available_filters": { "status": [ { "count": 48783, "slug": "answered" }, { "count": 11967, "slug": "resolved" } ], "type": [ { "count": 26090, "slug": "productissues" }, { "count": 13768, "slug": "serviceorrepair" }, { "count": 9375, "slug": "delivery" } ] }, "bbb_id": "1296", "business_id": "7039385", "complaints_summary": { "closed_last_12_months": 18470, "closed_last_3_years": 60750, "total_displayed": 10000, "unit": "complaints" }, "count": 10, "hidden_count": 1156, "id": "1296-7039385", "items": [ { "date": "2026-09-10", "id": "1296_7039385_25260612", "responses": [ { "author": "business", "date": "2026-09-12", "id": "1296_7039385_25260612_0", "text_html": "Hello,

I'm Naveen from Amazon.com. I'm writing in response to a complaint filed on your behalf by the Better Business Bureau BBB - I've provided the BBB with a copy of this message.

I'm very sorry to hear about the frustrating experience that you've had recently with our team regarding your order ID # *******************. I can certainly understand your request and upon checking, I see that refund of $32.06 was issued on September 11, 2026.

Thanks for your patience and understanding in this regard." }, { "author": "consumer", "date": "2026-09-12", "id": "1296_7039385_25260612_1", "text_html": " 
Hi BBB, 

I'm satisfied with the business's resolution to complaint ID ********.  

Thank you.

******* ****" } ], "status": "Resolved", "text": "Hello,I'm reaching out to escalate a ridiculous runaround I've been getting regarding a $32.06 refund credit that was explicitly promised to me for order #***-4226310-7460223.Two different Amazon support agents put their commitment in writing and confirmed the credit. But instead of honoring what your staff promised, your social media and email teams have completely ignored the proof, claimed it's a \"misunderstanding,\" and started spamming me with blind, automated scripts asking for info I've already provided multiple times. One of the agents even told me that the refund was issued and sent a confirmation email but it never arrived into my account balance.I have attached the screenshots proving the promised credit, the agent saying they issued the credit, and me being denied the refund I was promised. Please issue the $32.06 refund that was promised to my account gift card balance.", "type": "Product Issues" }, { "date": "2026-09-10", "id": "1296_7039385_25258985", "responses": [ { "author": "business", "date": "2026-09-11", "id": "1296_7039385_25258985_0", "text_html": "

Hello,

I'm ********* from Amazon.com. I'm writing in response to a complaint filed on your behalf by the Better Business Bureau BBB - I've provided the BBB with a copy of this message.

I'm sorry for the inconvenience you've experienced with regard to order refund.

Upon review, we see a refund has been issued on the order for $49.38 to your Amazon Gift Card balance on September 10, 2026. You can view your balance and usage history in Your Account here:

*************************************************

Thank you for your patience and understanding in this regard.

Regards,

*********

" }, { "author": "consumer", "date": "2026-09-11", "id": "1296_7039385_25258985_1", "text_html": " 
Hi BBB, 

I'm satisfied with the business's resolution to complaint ID ********.  However, they would not do anything without BBB's intervention so to say business these days are infringing on consumer rights and they are pushing their limits. Thank you for being around to help.

Thank you.
PL" } ], "status": "Resolved", "text": "I am filing this complaint regarding an unresolved refund for a returned item that Amazon's own tracking system confirms they received on September 4, 2026. Despite multiple contacts, I have not received my refund, and I have been given ***eated, inconsistent timelines with no resolution.Details:Order number: [111-3424847-0901051 Item: ******* Pro Rubber Hot Water Garden Hose 5/8\" x 50'Reason for return: The item was defective it broke after approximately 2 days of normal use. Connector crimp was not proper so connector become broken after initial ******** item was returned: Sept 1st, 2026 Date Amazon confirms receipt: September 4, 2026 (per Amazon's own tracking/system status)Refund status as of today: Not issued Contact history:I have contacted Amazon customer service 4 times regarding this issue with no resolution:Aug 27 Chat session. Representative requested photos of damaged item, I updated it. They initiated refund on my behalf, ***orted quality issue Sep 4 Chat session. Chat session whent idle and I disconnected Sep 4 Phone call. Was told 5 - 7 days for refund Sep 10 Phone call. Told to wait for refund to process, *** disconnected the call dispite requested for further support.Each contact has resulted in the same response a request to wait an additional 5-7 days despite the fact that Amazon's system already confirms receipt of the returned item. I am well within, and in fact past, the timeframe I was originally quoted.What I am requesting:I am requesting that Amazon process my refund of $49.38 immediately, given that they have had the returned item in their possession since September 4, 2026, and I have already fulfilled my obligation as a customer by returning the defective item promptly.", "type": "Product Issues" }, { "date": "2026-09-09", "id": "1296_7039385_25257842", "responses": [ { "author": "business", "date": "2026-09-11", "id": "1296_7039385_25257842_0", "text_html": "Hello *****,

I'm ******* from Amazon.com and I'm writing in response to a complaint filed on your behalf by the Better Business Bureau BBB - I've provided the BBB with a copy of this message.

I understand you're looking for prepaid label to return the damaged printer.

As the order is shipped and sold by third party seller, KOMHOW DTF Printer, we do not have option to provide prepaid label. Hence, in this case, as informed by the Guarantee team.

Please return the order to the seller at the following address:
-- Return merchandise authorization (RMA) number, if applicable
-- Return address *****-KRESTRICTED:PHONE_NUMBER , *******************************************
****************, ** RESTRICTED:PHONE_NUMBER US

We recommend following these best practices to be sure that the seller receives your package:
-- Include the order number and any return authorization number on or inside the package.
-- Insure the package.
-- Use signature confirmation.
-- Provide your return tracking number and ship receipt to the seller.
-- Ship items via **** when the seller's return address is a PO Box.

Return shipping will be refunded for damaged or defective items and may be covered for other reasons once the return is delivered to the seller. Please share the ship receipt of your return to get a refund for your return costs. To learn more about return shipping, go to \"A-to-z Guarantee\":
************************************************************************************************************

We appreciate your understanding.

Regards,
*******
Amazon.com
*****************************" }, { "author": "consumer", "date": "2026-09-11", "id": "1296_7039385_25257842_1", "text_html": "I don't have 1500 to sell it back, I paid almost two thousand dollars for this thing. If they're gonna supposedly reimburse me, they can pay for a prepaid label. If I knew what was going to be like this, I wouldn't even let any robotic. But, I mean, I can send you pictures of everything that it does. That is, you know I won't do, but I don't have that kind of money just to send it back.

" } ], "status": "Answered", "text": "I got this in July, 2026. It is damaged it wont go to my computer right. we did a print test gives me nothing but ink on paper. make a lound sound. It dosent work right. **** wont it a prepaid lable to send it back and get my money back. Thats all iv been asking for been alot of game playing with them.", "type": "Service or Repair Issues" } ], "name": "Amazon.com", "next_page": 2, "observed_at_ms": 1789483200000, "page": 1, "page_size": 10, "profile_url": "https://www.bbb.org/us/wa/seattle/profile/ecommerce/amazoncom-1296-7039385", "source_url": "https://www.bbb.org/us/wa/seattle/profile/ecommerce/amazoncom-1296-7039385/complaints?page=1", "status_filter": null, "terms_url": "https://www.bbb.org/terms-of-use", "total_found": 10000, "total_found_note": "bbb.org caps numFound at 10000; use complaints_summary for exact closed counts", "type_filter": null } ``` ### Profile - Capability: `businesses/profile` - Description: The full bbb.org business profile for one business: names, website and phone, categories, BBB letter grade with reasons, accreditation status and dates, file-opened / started / incorporated dates, address and coordinates, entity type, years in business, complaint counts (closed in the last 3 years and 12 months), review count and average stars, alerts such as government actions, licences and management. - Instructions: You have a BBB `id` (from search or resolve) or a pasted bbb.org profile URL and need ratings, accreditation and complaint summary figures. - Cost: 5 credits per call - Capability file: [Profile](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/profile) Accepted options: - `id` (string): BBB identity `-` as it appears at the end of the profile URL (e.g. 0825-1000223803). Pattern: ^[0-9]{4}-[0-9]{1,12}$. Example: `-` - `url` (string): A pasted bbb.org business profile URL, or any of its sub pages (/complaints, /customer-reviews, /leave-a-review). Exactly one of `id` or `url`. Example: `` Response schema example: ```json { "accreditation": { "accredited_since": "2024-01-16", "is_accredited": true, "revoked_at": null, "status_code": 0, "texts": [] }, "address": { "city": "Austin", "country_code": 2, "formatted": "8410 Georgian Dr # B, Austin, TX 78753-6003", "is_us_based": true, "postal_code": "78753-6003", "state": "TX", "street": "8410 Georgian Dr # B", "street2": null }, "alerts": [], "alt_names": [ "Calixto Plumbing, LLC" ], "attribution": "Better Business Bureau (bbb.org)", "bbb_id": "0825", "business_id": "1000223803", "categories": [ { "name": "Plumber", "url": "https://www.bbb.org/us/tx/austin/category/plumber" }, { "name": "Plumbing Renovation", "url": "https://www.bbb.org/us/tx/austin/category/plumbing-renovation" }, { "name": "Commercial Plumber", "url": "https://www.bbb.org/us/tx/austin/category/commercial-plumber" } ], "complaints_summary": { "closed_last_12_months": 0, "closed_last_3_years": 0, "total_displayed": 0, "unit": "complaints" }, "complaints_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803/complaints", "dates": { "bbb_file_opened": "2024-01-16", "business_started": "2023-03-14", "business_started_locally": null, "incorporated": "2023-03-14", "new_owner": null }, "employees": null, "entity_type": "Limited Liability Company (LLC)", "has_high_risk_category": false, "id": "0825-1000223803", "is_multi_location": false, "is_out_of_business": false, "latitude": 30.3, "licenses": [ { "agency": "Texas State Board of Plumbing Examiners", "agency_state": "TX", "expiration_date": "2026-11-30", "notes": null, "number": "44648" } ], "local_bbb": { "id": "0825", "name": "BBB Heart of Texas", "url": "https://www.bbb.org/local-bbb/bbb-serving-the-heart-of-texas" }, "logo_url": "https://m.bbb.org/prod/ProfileImages/2024/1f7a8bd4-fdd2-45ca-8963-5c246e1d3b85.png", "longitude": -97.76, "management": [ { "is_principal": true, "name": "Mr. Omar Calixto Cordoba", "title": "Owner/Manager" } ], "name": "Calixto Plumbing", "observed_at_ms": 1789483200000, "phone": "(512) 945-3143", "primary_category": { "id": "10113-000", "name": "Plumber" }, "rating": { "grade": "A+", "methodology_url": "https://www.bbb.org/all/overview-of-ratings", "not_rated_reason": null, "reasons": [ "Customer Reviews are not used in the calculation of the BBB Letter Grade Rating." ], "scale": "BBB letter grade A+ to F; NR = not rated" }, "reviews_summary": { "average_star_rating": 1, "scale": "stars_1_to_5", "suppressed": false, "total": 1 }, "reviews_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803/customer-reviews", "service_area": null, "source_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803", "terms_url": "https://www.bbb.org/terms-of-use", "website": "https://calixtoplumbing.com/", "years_in_business": 3 } ``` ### Resolve - Capability: `businesses/resolve` - Description: Resolve a pasted bbb.org URL (profile or any sub page) or a BBB `id` to the canonical identity: `id`, local BBB id, business id, primary and alternate names, canonical profile / complaints / reviews URLs, city and state, letter grade, accreditation flag and complaints closed in the last 3 years. - Instructions: Normalise a bbb.org link an agent found elsewhere, or confirm an `id` exists, before calling profile or complaints. - Cost: 5 credits per call - Capability file: [Resolve](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/resolve) Accepted options: - `id` (string): BBB identity `-` as it appears at the end of the profile URL (e.g. 0825-1000223803). Pattern: ^[0-9]{4}-[0-9]{1,12}$. Example: `-` - `url` (string): A pasted bbb.org business profile URL, or any of its sub pages (/complaints, /customer-reviews, /leave-a-review). Exactly one of `id` or `url`. Example: `` Response schema example: ```json { "alt_names": [ "Calixto Plumbing, LLC" ], "attribution": "Better Business Bureau (bbb.org)", "bbb_id": "0825", "business_id": "1000223803", "city": "Austin", "complaints_closed_last_3_years": 0, "complaints_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803/complaints", "id": "0825-1000223803", "input_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803/customer-reviews", "is_accredited": true, "is_out_of_business": false, "name": "Calixto Plumbing", "observed_at_ms": 1789483200000, "rating": "A+", "reviews_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803/customer-reviews", "source_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803", "state": "TX", "terms_url": "https://www.bbb.org/terms-of-use", "website": "https://calixtoplumbing.com/" } ``` ### Search - Capability: `businesses/search` - Description: Find businesses on bbb.org by name or category words and an optional city/state or postal code, with the site's own filters (accredited only, minimum letter grade, category id, state, radius) and sort. Returns 15 items per page with BBB identity, canonical profile URL, letter grade, accreditation flag, categories, address, phones and service areas, plus the filter values bbb.org offers. - Instructions: Start here to find a business and its `id` for profile / complaints / resolve, or to list businesses in a category and place. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/bbb-org/businesses/search) Accepted options: - `accredited_only` (boolean): Only BBB Accredited Businesses (`filter_accredited`). Example: `false` - `category_id` (string): Restrict to one BBB type-of-business id (`filter_category`), taken from a previous search's `filters.categories`. Pattern: ^[0-9]{5}-[0-9]{3}$. Example: `filter_category` - `country` (string): Market to search: bbb.org serves the United States and Canada. Example: `USA` - `distance_miles` (number): Radius around `location` (`filter_distance`); requires `location`. Example: `5` - `location` (string): City and state/province (`Austin, TX`), or a ZIP / postal code (bbb.org `find_loc`). Omit for a nationwide search. Example: `Austin, TX` - `min_rating` (string): Minimum BBB letter grade (`filter_ratings`): A means A and above. Example: `A` - `page` (number): 1-based result page of 15 items; bbb.org exposes at most 15 pages per query. Example: `1` - `query` (string): Business name or category words (bbb.org `find_text`). Required unless `category_id` is given. Example: `find_text` - `sort` (string): bbb.org sort order. Distance requires `location`. Example: `Relevance` - `state` (string): Restrict to one state/province code (`filter_state`). Pattern: ^[A-Z]{2}$. Example: `filter_state` Response schema example: ```json { "accredited_only": false, "attribution": "Better Business Bureau (bbb.org)", "count": 15, "filters": { "categories": [ { "label": "Plumber", "value": "10113-000" }, { "label": "Commercial Plumber", "value": "10113-100" }, { "label": "Plumbing Renovation", "value": "10113-300" } ], "states": [ { "label": "MA", "value": "MA" }, { "label": "TX", "value": "TX" }, { "label": "VA", "value": "VA" } ] }, "items": [ { "accreditation_status": null, "accredited_charity": true, "address": { "city": "Austin", "postal_code": "78753-6003", "state": "TX", "street": "8410 Georgian Dr # B" }, "address_id": "405686", "bbb_id": "0825", "business_id": "1000223803", "categories": [ { "id": "10113-000", "name": "Plumber" }, { "id": "10113-300", "name": "Plumbing Renovation" }, { "id": "10113-100", "name": "Commercial Plumber" } ], "distance_miles": null, "id": "0825-1000223803", "is_accredited": true, "is_charity": false, "latitude": 30.3, "local_bbb": { "id": "0825", "name": "BBB Heart of Texas" }, "location_url": null, "logo_url": "https://m.bbb.org/prod/ProfileImages/2024/1f7a8bd4-fdd2-45ca-8963-5c246e1d3b85.png", "longitude": -97.76, "name": "Calixto Plumbing", "out_of_business_status": null, "phones": [ "(512) 945-3143" ], "primary_category": { "id": "10113-000", "name": "Plumber" }, "rating": "A+", "rating_score": 98.49, "result_id": "0825_1000223803_405686", "service_areas": [ "Bell County, TX", "Burnet County, TX", "Lee County, TX" ], "source_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803" }, { "accreditation_status": null, "accredited_charity": true, "address": { "city": "Austin", "postal_code": "78748-1448", "state": "TX", "street": "10415 Old Manchaca Rd Ste 205 # Suit" }, "address_id": "432144", "bbb_id": "0825", "business_id": "1000194310", "categories": [ { "id": "10113-000", "name": "Plumber" } ], "distance_miles": null, "id": "0825-1000194310", "is_accredited": true, "is_charity": false, "latitude": 30.3, "local_bbb": { "id": "0825", "name": "BBB Heart of Texas" }, "location_url": null, "logo_url": "https://m.bbb.org/prod/ProfileImages/2025/983b8958-9f7f-4b1d-b15c-fd154b889909.jpg", "longitude": -97.76, "name": "Al Mac Plumbing & Gas, LLC", "out_of_business_status": null, "phones": [ "(512) 645-8578" ], "primary_category": { "id": "10113-000", "name": "Plumber" }, "rating": "A+", "rating_score": 100, "result_id": "0825_1000194310_432144", "service_areas": [ "78730", "78731", "78732" ], "source_url": "https://www.bbb.org/us/tx/austin/profile/plumber/al-mac-plumbing-gas-llc-0825-1000194310" }, { "accreditation_status": null, "accredited_charity": true, "address": { "city": "Austin", "postal_code": "78704-0012", "state": "TX", "street": "PO Box 40698" }, "address_id": "445822", "bbb_id": "0825", "business_id": "1000237688", "categories": [ { "id": "10113-000", "name": "Plumber" } ], "distance_miles": null, "id": "0825-1000237688", "is_accredited": true, "is_charity": false, "latitude": 30.3, "local_bbb": { "id": "0825", "name": "BBB Heart of Texas" }, "location_url": null, "logo_url": "https://m.bbb.org/prod/ProfileImages/2025/604bb2ed-4a9c-46d3-b9f6-22c33a19671f.png", "longitude": -97.76, "name": "Abundant Plumbing LLC", "out_of_business_status": null, "phones": [ "(512) 201-9978" ], "primary_category": { "id": "10113-000", "name": "Plumber" }, "rating": "A", "rating_score": 94, "result_id": "0825_1000237688_445822", "service_areas": [ "Hays County, TX", "Travis County, TX", "Williamson County, TX" ], "source_url": "https://www.bbb.org/us/tx/austin/profile/plumber/abundant-plumbing-llc-0825-1000237688" } ], "location": "Austin, TX", "next_page": 2, "observed_at_ms": 1789483200000, "page": 1, "page_size": 15, "query": "plumber", "related_categories": [ { "name": "Plumber", "url": "https://www.bbb.org/us/tx/austin/category/plumber" }, { "name": "Commercial Plumber", "url": "https://www.bbb.org/us/tx/austin/category/commercial-plumber" }, { "name": "Plumbing Renovation", "url": "https://www.bbb.org/us/tx/austin/category/plumbing-renovation" } ], "resolved_location": { "city": "Austin", "country": "US", "display_text": "Austin, TX", "lat_lng": "30.314613,-97.793745", "postal_code": "78732", "state": "TX" }, "sort": "Relevance", "source_url": "https://www.bbb.org/search?find_country=USA&find_text=plumber&find_loc=Austin%2C+TX&page=1", "terms_url": "https://www.bbb.org/terms-of-use", "total_pages": 15, "total_results": 2540 } ```