# Orbbit Branded Foods Search API

> Orbbit Branded Foods Search API is a paid API for AI agents from data-api.orbbit.co, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Search a database of packaged/branded food products by name, brand, category, barcode (UPC), or ingredient.

## Facts

- Endpoint: GET https://data-api.orbbit.co/v1/branded-foods?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orbbit-branded-foods-search-api-db5e1fb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TYBg1potC1RiYsBqeXqAk

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 orbbit-branded-foods-search-api-db5e1fb5
```

Example prompt: Search for Oreo branded food products containing 'chocolate' in the description — show me up to 20 results with their ingredient statements and category.

## When to prefer this

Use this endpoint when you need to search, discover, or look up packaged/branded food products by any combination of product name, brand, UPC barcode, category, or ingredient. Ideal for nutrition apps, grocery tools, barcode scanner features, ingredient filtering, or building food product catalogs. Prefer this over generic web search when structured, filterable food product data with ingredient statements is needed.

## Known failure modes

- Invalid or unrecognized category value returns an error — use GET /v1/branded-foods/categories to retrieve accepted values
- UPC not found returns an empty result set rather than an error
- No query parameters provided returns up to the default 50 items with no filtering
- Invalid cursor value causes pagination error
- Limit outside 1–200 range returns a validation error
- Payment failure (x402) blocks access if USDC balance is insufficient

## How this service works

Search for packaged food products by name, brand, category, barcode, or ingredient.

## Output

A paginated list of branded food products matching the search criteria, each including product name, brand, category, UPC barcode, and ingredient statement. A next_cursor field is included when additional pages are available.

## 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": [],
     "properties": {
      "upc": {
       "type": "string",
       "description": "Exact barcode (GTIN/UPC)"
      },
      "brand": {
       "type": "string",
       "description": "Brand owner, brand name, or sub-brand contains this, ignoring case"
      },
      "limit": {
       "type": "integer",
       "description": "Page size, 1–200; defaults to 50"
      },
      "cursor": {
       "type": "string",
       "description": "The next_cursor of the previous page; absent means the first page"
      },
      "category": {
       "type": "string",
       "description": "Exact category, ignoring case. See GET /v1/branded-foods/categories for the accepted values"
      },
      "ingredient": {
       "type": "string",
       "description": "Ingredient statement contains this, ignoring case"
      },
      "description": {
       "type": "string",
       "description": "Product name contains this, ignoring case; empty or absent means no filter"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orbbit-branded-foods-search-api-db5e1fb5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data-api.orbbit.co](https://www.zero.xyz/host/data-api.orbbit.co/llms.txt)