# Faire Brand & Product Scraper (x402)

> Faire Brand & Product Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured brand and product data from Faire.com by category, keyword, brand token, or URL, returning enriched brand profiles and product records.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/faire?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/faire-brand-product-scraper-x402-07790e4b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pRtOe5iDHG7vZSnBSXKuz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability faire-brand-product-scraper-x402-07790e4b -d '<json body>'
```

Example prompt: Find me up to 50 eco-friendly, women-owned brands on Faire in the candles and home fragrance category based in the US — include their full profiles with descriptions and locations.

## When to prefer this

Use this endpoint when you need structured, filterable brand and product data from Faire.com — especially for wholesale sourcing research, supplier discovery, or building brand databases. Prefer it over general web scrapers when you need Faire-specific fields like brand tokens, values (women-owned, eco-friendly, etc.), minimums, and ratings already parsed into structured records. The pay-per-call model (with no charge for empty runs) makes it low-risk for exploratory queries.

## Known failure modes

- Empty results if category URL or keyword matches no public Faire listings
- Invalid brand token returns no items
- Rate limiting or access restrictions from Faire may yield partial results
- No charge for failed or empty runs, so zero-result responses are safe to retry
- scrapeAllBrands with low maxResults may stop early before covering full sitemap

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of results and an array of brand (and optionally product) records, each with fields such as brand name, brand token, brand URL, city, state, country, description, and brand type. When enrichBrandProfile is true, additional details like location, values, ratings, minimums, and social links are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "state": {
   "type": "string",
   "description": "Keep brands whose public state or region contains this text."
  },
  "country": {
   "type": "string",
   "description": "Keep brands whose public origin, production country, or shipping country contains this name or code."
  },
  "keyword": {
   "type": "string",
   "description": "Keep brands whose name, description, category, or subcategory contains this text. This filters discovered brands, not the site search."
  },
  "brandUrls": {
   "type": "array",
   "description": "Specific brand pages with a b_ token in the URL, or bare b_ tokens."
  },
  "startUrls": {
   "type": "array",
   "description": "Public category, supplier, brand-token, or product-token URLs on faire.com."
  },
  "categories": {
   "type": "array",
   "description": "Public category names or category URLs. Each category yields the brands shown in its first public listing."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum total brand and product records. Set to 0 for no cap."
  },
  "brandTokens": {
   "type": "array",
   "description": "Specific b_ brand tokens."
  },
  "brandValues": {
   "type": "array",
   "description": "Keep brands with all selected values. One value also narrows a category URL. Options: women-owned, eco-friendly, hand-made, organic, gives-back, small-batch, not-sold-on-amazon."
  },
  "minProducts": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Keep brands with at least this many active products."
  },
  "productUrls": {
   "type": "array",
   "description": "Specific product pages with a p_ token in the URL, or bare p_ tokens."
  },
  "scrapeAllBrands": {
   "type": "boolean",
   "default": false,
   "description": "Discover brand tokens through public brand sitemaps, then fetch profiles until the result limit is reached."
  },
  "enrichBrandProfile": {
   "type": "boolean",
   "default": true,
   "description": "Fetch each brand profile for description, location, values, rating details, minimums, and social link. Turn off for faster tile-only category results."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "city": null,
    "name": null,
    "type": null,
    "state": null,
    "brandUrl": null,
    "brandToken": null,
    "description": null,
    "basedInCountry": null
   }
  ],
  "product": "faire"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/faire-brand-product-scraper-x402-07790e4b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)