> ## Documentation Index
> Fetch the complete documentation index at: https://data-docs.orbbit.co/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> The base URL, authentication, and conventions shared by every Orbbit Data API endpoint.

Every endpoint below is listed with its parameters, example responses, and a **Try it** button that sends a real request from your browser. For what each data set means and why it's useful, see the **Documentation** tab.

## Base URL

All requests go to:

```text theme={null}
https://data-api.orbbit.co
```

## Authentication

Send your API key in the `Authorization` header on every request:

```bash theme={null}
--header 'authorization: Bearer YOUR_API_KEY'
```

Each endpoint needs its own scope on the key. See [Authentication](https://data-docs.orbbit.co/authentication.md) for how to create a key and choose its scopes.

## Pricing

Every successful call to a paid endpoint is charged to your balance, including calls sent with **Try it**. Two endpoints are free. See [Pricing & Billing](https://data-docs.orbbit.co/pricing.md) for the price of each endpoint.

## Versions

The version is part of the path. Every endpoint starts with `/v1`.

## Requests and responses

* Every endpoint is a `GET` and only reads data.
* Responses are JSON with `snake_case` field names. A single record comes back as `{ "data": { ... } }`, a list as `{ "data": [ ... ] }`.
* Lists that can be long return one page at a time with a `next_cursor`. Pass it back as `cursor` to get the next page; `null` means you have them all.
* Every error has the same shape, `{ "error": { "type", "message" } }`. See [Errors](https://data-docs.orbbit.co/errors.md).

## Endpoints

| Section | Name | Endpoint | Scope | Price |
| - | - | - | - | - |
| Commodities | [List Commodities](https://data-docs.orbbit.co/api-reference/commodities/list-commodities.md) | `GET /v1/commodities` | `search-commodities` | Free |
| Commodities | [Get Commodity Metric Values](https://data-docs.orbbit.co/api-reference/commodities/get-commodity-metric-values.md) | `GET /v1/commodities/metric-values` | `get-commodity-prices` | \$0.01 |
| CPG › Branded Food | [Search Branded Foods](https://data-docs.orbbit.co/api-reference/branded-food/search-branded-foods.md) | `GET /v1/branded-foods` | `search-branded-foods` | \$0.01 |
| CPG › Branded Food | [List Branded Food Categories](https://data-docs.orbbit.co/api-reference/branded-food/list-branded-food-categories.md) | `GET /v1/branded-foods/categories` | `search-branded-foods` | Free |
| CPG › Branded Food | [Get a Branded Food](https://data-docs.orbbit.co/api-reference/branded-food/get-a-branded-food.md) | `GET /v1/branded-foods/{id}` | `get-branded-foods` | \$0.01 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.