--- type: "firecrawl-provider" description: "Explore Allbirds collections, product suggestions, size-level offers and published materials/care details." use_when: "Explore Allbirds collections, product suggestions, size-level offers and published materials/care details." categories: "Retail" capabilities: 6 credits_per_call: 5 --- # Allbirds on Firecrawl Alexandria Explore Allbirds collections, product suggestions, size-level offers and published materials/care details. - Categories: Retail - Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail) - Provider key: `allbirds-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/allbirds-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/openapi.json) ## Capabilities - [Collections](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/collections): List curated collection links from the Allbirds US homepage. Partial discovery, not every archived collection. - [Details](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/details): Read substantive product design, materials, sustainability and care sections. Unsupported layouts fail closed. - [Product](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/product): Read the canonical product profile and source-labelled offer currency; stock is a source snapshot. - [Products](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/products): Browse one Allbirds collection page. Follow next_page with the same collection and limit; prices are omitted until product details supply currency. - [Search](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/search): Find predictive product suggestions for a query. Up to ten results; this is not exhaustive or paginated search. - [Variants](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/variants): Compare published sizes, SKUs, color labels and size-level prices and stock for one product. ## 1. Choose this provider when Explore Allbirds collections, product suggestions, size-level offers and published materials/care details. ## 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": "allbirds-com", "capability": "products/collections", "options": {} } ``` ## 3. Add provider options Use only the options needed for the task: ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "allbirds-com", capability: "products/collections", options: {}, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "allbirds-com", "capability": "products/collections", "options": {} }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "allbirds-com", "capability": "products/collections", "options": {} } }' ``` ### CLI ```sh firecrawl scrape 'allbirds-com/products/collections' \ --options '{}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "allbirds-com", "capability": "products/collections", "options": {} } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "allbirds-com", "capability": "products/collections", "options": {} } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "complete": false, "next_page": null, "observed_at_ms": 1789506000000, "records": [ { "handle": "new-arrivals-26", "name": "New Arrivals", "url": "https://www.allbirds.com/collections/new-arrivals-26" } ], "source_url": "https://www.allbirds.com/", "warnings": [ "US storefront only. Discovery omits unlabelled prices; product offers retain explicit source currency. Tax and shipping basis are unknown. Stock is a source snapshot, not a reservation. Search suggestions and homepage collections are partial." ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Collections - Capability: `products/collections` - Description: List curated collection links from the Allbirds US homepage. Partial discovery, not every archived collection. - Instructions: List curated collection links from the Allbirds US homepage. Partial discovery, not every archived collection. - Cost: 5 credits per call - Capability file: [Collections](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/collections) Accepted options: Response schema example: ```json { "complete": false, "next_page": null, "observed_at_ms": 1789506000000, "records": [ { "handle": "new-arrivals-26", "name": "New Arrivals", "url": "https://www.allbirds.com/collections/new-arrivals-26" } ], "source_url": "https://www.allbirds.com/", "warnings": [ "US storefront only. Discovery omits unlabelled prices; product offers retain explicit source currency. Tax and shipping basis are unknown. Stock is a source snapshot, not a reservation. Search suggestions and homepage collections are partial." ] } ``` ### Details - Capability: `products/details` - Description: Read substantive product design, materials, sustainability and care sections. Unsupported layouts fail closed. - Instructions: Read substantive product design, materials, sustainability and care sections. Unsupported layouts fail closed. - Cost: 5 credits per call - Capability file: [Details](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/details) Accepted options: - `url` (string, required): Pattern: ^https://www\.allbirds\.com/products/[a-z0-9-]+$. Example: `` Response schema example: ```json { "complete": true, "next_page": null, "observed_at_ms": 1789506000000, "records": [ { "section": "whyWeMadeThis", "text": "A new take on our fan-favorite Dasher, made for busy days and spontaneous plans. Lightweight, breathable comfort keeps you cool as you move, with added heel protection where it counts. Fast when you want. Comfortable always. Thoughtfully designed Breathable tree knit upper for a light, cool feel Easy-entry heel tab for quick slip on and off Wool-blend lining for softness, socks optional Sugarcane-based SweetFoam® cushioning with responsive energy return Plush Featherbed™ memory foam insole for extra comfort and bounce Redesigned traction pattern for more grip on paved surfaces Best for Walking Jogging Commuting Light Workouts Everyday-ing Weight: 10.9oz (M9) 9.0oz (W7) Heel/Toe Drop: 7mm Stack Height: Heel: 22.9mm Toe: 15.9mm Country of Origin: Vietnam" } ], "source_url": "https://www.allbirds.com/products/mens-dasher-nz-anthracite", "warnings": [ "US storefront only. Discovery omits unlabelled prices; product offers retain explicit source currency. Tax and shipping basis are unknown. Stock is a source snapshot, not a reservation. Search suggestions and homepage collections are partial." ] } ``` ### Product - Capability: `products/product` - Description: Read the canonical product profile and source-labelled offer currency; stock is a source snapshot. - Instructions: Read the canonical product profile and source-labelled offer currency; stock is a source snapshot. - Cost: 5 credits per call - Capability file: [Product](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/product) Accepted options: - `url` (string, required): Pattern: ^https://www\.allbirds\.com/products/[a-z0-9-]+$. Example: `` Response schema example: ```json { "complete": true, "next_page": null, "observed_at_ms": 1789506000000, "records": [ { "brand": "Allbirds", "description": "A new take on our fan-favorite Dasher, made for busy days and spontaneous plans. Lightweight, breathable comfort keeps you cool as you move, with added heel protection where it counts. Fast when you want. Comfortable always.", "group_id": "MENS_DASHER_NZ", "name": "Men's Dasher NZ", "offer": { "amount": 140, "available": true, "currency": "USD", "shipping_included": null, "tax_basis": "unknown" } } ], "source_url": "https://www.allbirds.com/products/mens-dasher-nz-anthracite", "warnings": [ "US storefront only. Discovery omits unlabelled prices; product offers retain explicit source currency. Tax and shipping basis are unknown. Stock is a source snapshot, not a reservation. Search suggestions and homepage collections are partial." ] } ``` ### Products - Capability: `products/products` - Description: Browse one Allbirds collection page. Follow next_page with the same collection and limit; prices are omitted until product details supply currency. - Instructions: Browse one Allbirds collection page. Follow next_page with the same collection and limit; prices are omitted until product details supply currency. - Cost: 5 credits per call - Capability file: [Products](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/products) Accepted options: - `collection` (string, required): Pattern: ^[a-z0-9-]+$. Example: `` - `limit` (number): limit Example: `20` - `page` (number): page Example: `1` Response schema example: ```json { "complete": false, "next_page": 2, "observed_at_ms": 1789506000000, "records": [ { "available": true, "handle": "mens-dasher-nz-anthracite", "name": "Men's Dasher NZ - Anthracite (Dark Anthracite Sole)", "price": null, "url": "https://www.allbirds.com/products/mens-dasher-nz-anthracite" } ], "source_url": "https://www.allbirds.com/collections/mens/products.json?limit=2&page=1", "warnings": [ "US storefront only. Discovery omits unlabelled prices; product offers retain explicit source currency. Tax and shipping basis are unknown. Stock is a source snapshot, not a reservation. Search suggestions and homepage collections are partial." ] } ``` ### Search - Capability: `products/search` - Description: Find predictive product suggestions for a query. Up to ten results; this is not exhaustive or paginated search. - Instructions: Find predictive product suggestions for a query. Up to ten results; this is not exhaustive or paginated search. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/search) Accepted options: - `limit` (number): limit Example: `10` - `query` (string, required): Pattern: ^[^\x00-\x1F\x7F]+$. Example: `` Response schema example: ```json { "complete": false, "next_page": null, "observed_at_ms": 1789506000000, "records": [ { "available": true, "handle": "mens-dasher-nz-natural-black-blizzard", "name": "Men's Dasher NZ - Natural Black (Blizzard Sole)", "price": null, "url": "https://www.allbirds.com/products/mens-dasher-nz-natural-black-blizzard" } ], "source_url": "https://www.allbirds.com/search/suggest.json?q=dasher&resources%5Btype%5D=product&resources%5Blimit%5D=2", "warnings": [ "US storefront only. Discovery omits unlabelled prices; product offers retain explicit source currency. Tax and shipping basis are unknown. Stock is a source snapshot, not a reservation. Search suggestions and homepage collections are partial." ] } ``` ### Variants - Capability: `products/variants` - Description: Compare published sizes, SKUs, color labels and size-level prices and stock for one product. - Instructions: Compare published sizes, SKUs, color labels and size-level prices and stock for one product. - Cost: 5 credits per call - Capability file: [Variants](https://firecrawl.dev/alexandria/agents/providers/allbirds-com/products/variants) Accepted options: - `url` (string, required): Pattern: ^https://www\.allbirds\.com/products/[a-z0-9-]+$. Example: `` Response schema example: ```json { "complete": true, "next_page": null, "observed_at_ms": 1789506000000, "records": [ { "color": "Men's Dasher NZ - Anthracite (Dark Anthracite Sole)", "name": "Men's Dasher NZ - Anthracite (Dark Anthracite Sole) - Size 8", "offer": { "amount": 140, "available": false, "currency": "USD", "shipping_included": null, "tax_basis": "unknown" }, "size": "8", "sku": "A12417M080", "url": "https://www.allbirds.com/products/mens-dasher-nz-anthracite?size=8" } ], "source_url": "https://www.allbirds.com/products/mens-dasher-nz-anthracite", "warnings": [ "US storefront only. Discovery omits unlabelled prices; product offers retain explicit source currency. Tax and shipping basis are unknown. Stock is a source snapshot, not a reservation. Search suggestions and homepage collections are partial." ] } ```