# SiteCheck Shop & Social – Open Beauty Facts Brand Products

> SiteCheck Shop & Social – Open Beauty Facts Brand Products is a paid API for AI agents from api.shopsocial-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns beauty and personal-care products from Open Beauty Facts for a given brand, including name, barcode, size, categories, and product page URL.

## Facts

- Endpoint: GET https://api.shopsocial-api.workers.dev/api/ecommerce/openbeautyfacts-products?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-shop-social-open-beauty-facts-brand-products-c367c0a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UyX0Iud8x6tKWZZazJufH

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 sitecheck-shop-social-open-beauty-facts-brand-products-c367c0a7
```

Example prompt: Can you look up beauty products from The Ordinary on Open Beauty Facts and show me up to 10 of them with their barcodes and sizes?

## When to prefer this

Choose this endpoint when you need free, community-sourced beauty and personal-care product metadata (names, barcodes, sizes, categories) organized by brand from the Open Beauty Facts database. It is ideal for product lookup, barcode retrieval, and catalog browsing when price and stock data are not required. Prefer it over general e-commerce APIs when the focus is cosmetics/personal-care and open data provenance is acceptable.

## Known failure modes

- Brand not found or no products in Open Beauty Facts — returns empty products array with total 0
- Invalid brand string (disallowed characters) — likely a 400 or validation error
- Limit out of range (below 1 or above 20) — may return default of 5 or an error
- Open Beauty Facts upstream unavailable — may return 502 or timeout
- Rate limiting or payment failure — 402 response requiring x402 payment

## How this service works

Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the queried brand name, total number of matching products, the Open Beauty Facts source URL, a timestamp of when the data was checked, and an array of products each with name, barcode, size, brand, categories, and a direct Open Beauty Facts product page URL. Does not include prices or stock information.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "brand"
     ],
     "properties": {
      "brand": {
       "type": "string",
       "description": "Brand name, e.g. 'the ordinary' (letters, digits, spaces, & ' . -)"
      },
      "limit": {
       "type": "string",
       "description": "How many products, 1 to 20 (default 5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "brand": "the ordinary",
  "total": 14,
  "source": "https://world.openbeautyfacts.org",
  "products": [
   {
    "url": "https://world.openbeautyfacts.org/product/0769915195712/caffeine-solution-the-ordinary",
    "name": "Caffeine solution",
    "size": "30 mL",
    "brand": "The Ordinary",
    "barcode": "0769915195712",
    "categories": "non-food-products, open-beauty-facts"
   },
   {
    "url": "https://world.openbeautyfacts.org/product/0769915190670/caffeine-solution-5-egcg-the-ordinary",
    "name": "Caffeine Solution 5% + EGCG",
    "size": "30ml",
    "brand": "The Ordinary",
    "barcode": "0769915190670",
    "categories": "Cafffeine"
   }
  ],
  "checkedAt": "2026-10-23T09:37:45.967Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-shop-social-open-beauty-facts-brand-products-c367c0a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shopsocial-api.workers.dev](https://www.zero.xyz/host/api.shopsocial-api.workers.dev/llms.txt)
