ismworld.org APIwww.ismworld.org ↗
Access monthly ISM Manufacturing PMI reports via API. Retrieve headline PMI values, sub-indices, commentary, and industry-level data tables.
curl -X GET 'https://api.parse.bot/scraper/3e053129-cacc-4423-87ea-13d531fce8e3/get_manufacturing_report?month=january' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the ISM Manufacturing PMI report for a given month. Returns headline PMI value, at-a-glance summary table with all sub-indices, analyst commentary, respondent quotes, and detailed sub-index breakdown tables.
| Param | Type | Description |
|---|---|---|
| month | string | Month name for the report (e.g., 'march', 'february', 'january'). Case-insensitive. Must be a full month name in English. |
{
"type": "object",
"fields": {
"summary": "array of strings - First 5 summary paragraphs",
"headline": "string - Headline text (e.g., 'Manufacturing PMI® at 52.7%')",
"pmi_value": "number - Headline PMI index value",
"at_a_glance": "array of objects - Summary table rows with index_name, current_month_value, previous_month_value, percentage_point_change, direction, rate_of_change, trend_months",
"sub_indices": "object - Detailed sub-index tables keyed by name, each with headers array and data array",
"report_title": "string - Full report title including month and year",
"current_month": "string - Current report month abbreviation (e.g., 'Mar')",
"previous_month": "string - Previous month abbreviation (e.g., 'Feb')",
"full_commentary": "array of strings - All commentary paragraphs",
"industries_growing": "array of strings - Industries reporting growth",
"respondent_comments": "array of strings - Industry respondent quotes",
"industries_contracting": "array of strings - Industries reporting contraction"
},
"sample": {
"data": {
"summary": [
"(Tempe, Arizona) — Economic activity in the manufacturing sector expanded in March..."
],
"headline": "Manufacturing PMI®at 52.7%",
"pmi_value": 52.7,
"at_a_glance": [
{
"direction": "Growing",
"index_name": "Manufacturing PMI",
"trend_months": 3,
"rate_of_change": "Faster",
"current_month_value": 52.7,
"previous_month_value": 52.4,
"percentage_point_change": "+0.3"
}
],
"sub_indices": {
"New Orders": {
"data": [
[
"Mar 2026",
"29.1",
"56.3"
]
],
"headers": [
"New Orders",
"% Higher",
"% Same"
]
}
},
"report_title": "March 2026 ISM®Manufacturing PMI®Report",
"current_month": "Mar",
"previous_month": "Feb",
"full_commentary": [
"(Tempe, Arizona) — Economic activity in the manufacturing sector expanded in March..."
],
"industries_growing": [
"Printing & Related Support Activities",
"Primary Metals",
"Transportation Equipment"
],
"respondent_comments": [
"\"This is expected to be a transition year for the U.S. trucking market...\" [Transportation Equipment]"
],
"industries_contracting": []
},
"status": "success"
}
}About the ismworld.org API
The ISM Manufacturing PMI API exposes one endpoint — get_manufacturing_report — that returns over 10 structured fields from the monthly ISM Manufacturing report, including the headline PMI value, a full at-a-glance sub-index table, analyst commentary paragraphs, respondent quotes, and lists of industries reporting growth. Each report covers production, new orders, employment, supplier deliveries, and inventories in a machine-readable format.
What the API Returns
The get_manufacturing_report endpoint accepts an optional month parameter (full month name, case-insensitive, e.g. 'march') and returns the full ISM Manufacturing PMI report for that month. The response includes pmi_value as a numeric headline figure, report_title with the full month and year context, and headline as the formatted string (e.g. 'Manufacturing PMI® at 52.7%'). Omitting the month parameter returns the most recently published report.
Sub-Index and Commentary Data
The at_a_glance array delivers a row-by-row breakdown of all tracked sub-indices — each row includes index_name, current_month_value, previous_month_value, percentage_point_change, and direction. The sub_indices object provides detailed data tables for each individual sub-index, with headers and data arrays suitable for direct table rendering or time-series extraction. The industries_growing array names specific manufacturing industries reporting expansion that month.
Commentary and Narrative Fields
The full_commentary array contains all analyst commentary paragraphs from the report, while summary provides the first five paragraphs for a quick overview. These fields include direct respondent quotes embedded within the commentary, reflecting actual survey participant sentiment. The current_month and previous_month fields give abbreviated month labels (e.g. 'Mar', 'Feb') to anchor the data in time without requiring date parsing.
- Plot a time-series chart of
pmi_valueacross multiple months to visualize manufacturing cycle expansions and contractions - Build an economic dashboard that displays the
at_a_glancesub-index table with month-over-monthpercentage_point_changehighlighted - Alert system that triggers when
pmi_valuecrosses the 50-point expansion/contraction threshold - NLP pipeline that ingests
full_commentaryand respondent quotes to extract sentiment signals from survey participants - Sector research tool that tracks which
industries_growingappear or disappear across consecutive monthly reports - Automated report digest that combines
headline,summary, andpmi_valueinto a briefing email or Slack notification - Backtest macroeconomic trading strategies by correlating historical
pmi_valueand sub-index readings with asset price data
| 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 | 250 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 ISM World have an official developer API?+
What does the `at_a_glance` field contain, and how is it different from `sub_indices`?+
at_a_glance is a flat summary table — one object per tracked index — showing the current value, previous value, point change, and direction for a quick comparison. sub_indices is a keyed object where each entry contains full headers and data arrays for that index, suitable for rendering a detailed historical or breakdown table within the report.How current is the data returned by the API?+
Does the API cover ISM Services PMI or non-US manufacturing indices?+
Can I retrieve reports for a specific year, or only by month name?+
month parameter accepts only a full month name (e.g. 'january'), not a year. If the same month name maps to multiple years in the archive, the API returns the most recent matching report. Fetching a specific year's report for a given month is not currently supported. You can fork this API on Parse and revise the endpoint to accept a year parameter alongside the month name.