# Mintel — 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.

> 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.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.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.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.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.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.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.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>"}'
```