# Mintel — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Browse and search Mintel's market research catalog. Retrieve free intelligence downloads, landing page content, store report listings by keyword or industry, full report details including pricing and table of contents, and the complete industry taxonomy from the Mintel Store.

**Category:** Business Directories | **Website:** [mintel.com/](https://mintel.com/) | **Docs:** [parse.bot/marketplace/0e44961c-8c14-4993-81c4-207730781219/mintel-com-api](https://parse.bot/marketplace/0e44961c-8c14-4993-81c4-207730781219/mintel-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/mintel/`
**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 free download landing page

Scrapes a Mintel free-download landing page for structured content: page title, introductory description, content sections with headings, expert blockquotes, call-to-action links, and the Microsoft Dynamics form identifier used for gated downloads. Sections are ordered as they appear on the page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the Mintel landing page to scrape (e.g. 'https://www.mintel.com/insights/consumer-research/global-consumer-trends/') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/mintel/get-free-download-landing-page \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get homepage free downloads

Retrieves free intelligence download cards from the Mintel homepage. Each card includes a title, optional description, URL to the landing page, and optional category tag. The set of downloads rotates periodically.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/mintel/get-homepage-free-downloads \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get store report detail

Fetches full details for a single Mintel Store report page including title, price, summary text, table of contents sections, classification tags, analyst information, and related report links. The URL must be a valid store.mintel.com report page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the store report page (e.g. 'https://store.mintel.com/report/us-coffee-and-rtd-coffee-market-report') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/mintel/get-store-report-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### List all store industries

Retrieves the full industry taxonomy from the Mintel Store navigation. Returns a hierarchical list of parent industries, each with a name, URL, and array of subcategories. Useful for discovering valid industry names for list_store_reports_by_industry.

**Estimated cost:** Metered

_No parameters required._

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

### List store reports by industry

Lists Mintel Store reports filtered by industry name. The industry value is case-sensitive and must match the exact name used in the Mintel Store (e.g. 'Coffee', 'Drinks', 'Food', 'Beauty and Cosmetics'). Returns up to 12 reports per page. Use list_all_store_industries to discover valid industry names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `industry` | string | Yes | Exact industry name as used in the Mintel Store (case-sensitive). Confirmed working values include 'Coffee', 'Drinks', 'Food', 'Beauty and Cosmetics', 'Foodservice'. Use list_all_store_industries to discover available names. |
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/mintel/list-store-reports-by-industry \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"industry":"<string>","page":"<integer>"}'
```

### Search store reports

Full-text keyword search across the Mintel Store report catalog. Returns up to 12 reports per page with title, URL, price, description, and industry classification. Results are auto-iterated via the page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |
| `query` | string | Yes | Search keyword (minimum 2 characters, e.g. 'coffee', 'beauty', 'sustainability') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/mintel/search-store-reports \
  -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://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.