Mintel APImintel.com ↗
Access Mintel's market research catalog via API. Search reports by keyword or industry, retrieve full report details, pricing, TOC, and free intelligence downloads.
What is the Mintel API?
The Mintel API provides 6 endpoints covering the Mintel Store and Mintel homepage, returning structured data across report listings, full report details, and free intelligence downloads. The search_store_reports endpoint accepts keyword queries and returns up to 12 paginated results per page, each with title, price, publication date, description, and industry. get_store_report_detail exposes per-report fields including the table of contents, analyst information, tags, and related reports.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/45643628-a711-452f-bc9e-0dc47402f096/get_homepage_free_downloads' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mintel-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Mintel SDK — search reports, browse industries, fetch landing pages."""
from parse_apis.Mintel_API import Mintel, Report, Industry, FreeDownload, LandingPage, NotFoundError
mintel = Mintel()
# Search for coffee reports, iterate first 5 results
for report in mintel.report_summaries.search(query="coffee", limit=5):
print(report.title, report.price, report.industry)
# Drill-down: take one search result and fetch full details
first = mintel.report_summaries.search(query="beauty", limit=1).first()
if first:
detail = first.details()
print(detail.title, detail.price)
for tag in detail.tags:
print(tag)
# Construct an industry and browse its reports
coffee = mintel.industry("Coffee")
for r in coffee.reports(limit=3):
print(r.title, r.url)
# List all industries in the taxonomy
for ind in mintel.industries.list(limit=5):
print(ind.name, ind.url)
for sub in ind.subcategories:
print(sub.name, sub.url)
# List free downloads from the homepage
for dl in mintel.free_downloads.list(limit=4):
print(dl.title, dl.url)
# Fetch a landing page by URL with typed error handling
try:
page = mintel.landing_pages.get(url="https://www.mintel.com/insights/consumer-research/global-consumer-trends/")
print(page.title, page.form_id)
for section in page.sections:
print(section.heading, section.text)
except NotFoundError as exc:
print(f"Landing page not found: {exc}")
print("exercised: report_summaries.search / details / industry.reports / industries.list / free_downloads.list / landing_pages.get")
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.
No input parameters required.
{
"type": "object",
"fields": {
"downloads": "array of free download objects with title, description, url, and category"
},
"sample": {
"data": {
"downloads": [
{
"url": "https://www.mintel.com/insights/consumer-research/global-consumer-trends/",
"title": "Free Report",
"category": null,
"description": null
},
{
"url": "https://www.mintel.com/insights/food-and-drink/global-food-and-drink-trends/",
"title": "Free Report",
"category": null,
"description": null
}
]
},
"status": "success"
}
}About the Mintel API
Report Discovery and Search
The search_store_reports endpoint accepts a query string (e.g. 'coffee' or 'sustainability') and an optional page integer for pagination. Each result in the reports array includes title, url, price, published_at, description, and industry. The total_count field lets you calculate how many pages exist. For browsing by category rather than keyword, list_store_reports_by_industry filters results by an exact, case-sensitive industry value such as 'Coffee' or 'Beauty and Cosmetics'; use list_all_store_industries first to retrieve valid industry names and their subcategories.
Full Report Details
get_store_report_detail takes the full URL of any store report page and returns the complete summary, table_of_contents as an array of section headings, price, tags (covering industry, report type, and market), related_reports, and an analyst object with name, role, and quote fields. The analyst field may be null for some reports.
Free Intelligence and Landing Pages
get_homepage_free_downloads returns all free download cards currently featured on the Mintel homepage, each with a title, description, and url. To go deeper on any individual free download, pass its URL to get_free_download_landing_page, which returns structured sections (each with heading and text), ctas, expert_quotes, a form_id for the associated Microsoft Dynamics form, and the page description.
Industry Taxonomy
list_all_store_industries returns the full hierarchical navigation taxonomy from the Mintel Store. Each entry in the industries array includes a name, url, and a subcategories array with nested name and url pairs. This endpoint requires no inputs and is useful for building category browsers or validating industry filter values before calling list_store_reports_by_industry.
The Mintel API is a managed, monitored endpoint for mintel.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mintel.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mintel.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a market research discovery tool that searches Mintel reports by product category keyword and surfaces price and publication date.
- Monitor new reports published within a specific industry by paginating
list_store_reports_by_industryand trackingpublished_atvalues. - Aggregate table-of-contents data from multiple reports via
get_store_report_detailto map common research themes across a sector. - Collect analyst quotes and report summaries at scale to feed a competitive intelligence database.
- Index the full Mintel Store industry taxonomy using
list_all_store_industriesto power a filterable category navigation UI. - Retrieve current free intelligence download titles and URLs from the homepage to alert subscribers when new free reports appear.
- Extract CTA links and expert quotes from free download landing pages to support content benchmarking research.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Mintel offer an official developer API?+
What does `get_store_report_detail` return beyond the report title and price?+
get_store_report_detail returns a summary string with the full report description, a table_of_contents array of section headings, a tags array covering industry, report type, and market classification, a related_reports array with titles and URLs, and an analyst object containing the analyst's name, role, and quote. The analyst field may be null for some reports.Are report purchase, download, or full-text content endpoints available?+
How does pagination work for `search_store_reports` and `list_store_reports_by_industry`?+
page integer parameter to retrieve subsequent pages. The total_count field in the response indicates the total number of matching reports, which you can divide by 12 to determine the total page count.Is report pricing data available in currencies other than USD?+
price field returned by both listing and detail endpoints reflects the price as displayed on the Mintel Store page, which is typically shown in USD. Multi-currency pricing is not currently exposed. You can fork the API on Parse and revise it to target locale-specific store URLs if Mintel surfaces regional pricing on those pages.