# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-mintel-com-api-0e44961c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-mintel-com-api-0e44961c/get_free_download_landing_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mintel-com-api-0e44961c/get_homepage_free_downloads \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mintel-com-api-0e44961c/get_store_report_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mintel-com-api-0e44961c/list_all_store_industries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mintel-com-api-0e44961c/list_store_reports_by_industry \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mintel-com-api-0e44961c/search_store_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```