# Knowde — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and retrieve detailed information about chemical products, ingredients, suppliers, and brands available on the Knowde marketplace. Find specific formulations, documents, and supplier storefronts across various industries and product categories to discover suppliers and sourcing options.

**Category:** Marketplaces | **Website:** [knowde.com/](https://knowde.com/) | **Docs:** [parse.bot/marketplace/6a465472-cd78-46e1-8321-57bd05414586/knowde-com-api](https://parse.bot/marketplace/6a465472-cd78-46e1-8321-57bd05414586/knowde-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/knowde/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get brand details

Get full details for a specific brand including products list, properties, related formulations, and documents. Brand slugs are discovered from search_brands or get_supplier_storefront results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_slug` | string | Yes | Brand slug (e.g. 'naturex', 'aerosil') |
| `storefront` | string | Yes | Supplier storefront slug (e.g. 'evonik') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/get-brand-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"brand_slug":"<string>","storefront":"<string>"}'
```

### Get formulation details

Get full details for a specific formulation including ingredients, application areas, and related products. Formulation slugs are discovered from search_formulations or get_supplier_storefront results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `formulation_slug` | string | Yes | Formulation slug (e.g. 'cleansing-oil-ul-5902-1', 'anti-blemish-cream') |
| `storefront` | string | Yes | Supplier storefront slug (e.g. 'evonik', 'givaudan-naturex') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/get-formulation-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"formulation_slug":"<string>","storefront":"<string>"}'
```

### Get product details

Retrieve full details for a specific product including chemical properties, description, related brand/company info, related documents, and formulations. Slugs are discovered from search_products results (company_slug and slug fields).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_slug` | string | Yes | Product slug from search results (slug field, e.g. 'aerosil-200') |
| `storefront` | string | Yes | Supplier storefront slug from search results (company_slug field, e.g. 'evonik', 'givaudan-naturex') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_slug":"<string>","storefront":"<string>"}'
```

### Get supplier storefront

Get information about a supplier's storefront including description, top brands, featured products, experts, browse sections, and contact info. Storefront slugs are discovered from search results (company_slug field).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `storefront_slug` | string | Yes | Supplier storefront slug from search results (company_slug field, e.g. 'evonik', 'givaudan-naturex') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/get-supplier-storefront \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"storefront_slug":"<string>"}'
```

### List industries

List all industry/market categories available on Knowde. Returns a tree structure with top-level markets and their children including titles, slugs, icons, and product counts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/list-industries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List product categories

List all product technology categories available on Knowde. Returns a tree structure with top-level technologies and their children including titles, slugs, icons, and product counts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/list-product-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search brands

Search for chemical ingredient brands on the Knowde marketplace. Returns paginated brand search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword for brands (e.g. 'silicone', 'aerosil', 'tego') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/search-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### Search documents

Search for chemical documents (TDS, SDS, brochures, etc.) on the Knowde marketplace. Returns paginated document search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword for documents (e.g. 'silicone', 'safety data sheet', 'titanium dioxide') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/search-documents \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### Search formulations

Search for chemical formulations on the Knowde marketplace. Returns paginated formulation search results with names, slugs, and company info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword for formulations (e.g. 'serum', 'moisturizer', 'cleansing') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/search-formulations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### Search products

Search for products on the Knowde chemical marketplace. Returns paginated results including product names, slugs, descriptions, properties, and metadata about available filters and categories. Each result includes the company_slug and product slug needed for get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword for products (e.g. 'silicone', 'fumed silica', 'titanium dioxide') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### Search suppliers

Search for chemical suppliers on the Knowde marketplace. Returns paginated supplier search results with company names, slugs, and descriptions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword for suppliers (e.g. 'evonik', 'basf', 'dow') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/knowde/search-suppliers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.