API Documentation

Free REST API for procurement price intelligence. No authentication required. CORS enabled.

Browse Index Catalog

GET /api/v1/catalog

List all available indices with filtering.

Parameters

category	Filter by category (e.g. Energy, Metals)	string
region	Filter by region (Europe, Asia-Pacific, Americas, etc.)	string
country	Filter by country (Germany, China, US, etc.)	string
q	Search query	string
limit	Results per page (max 500, default 100)	number
offset	Pagination offset	number

Example

curl "https://your-domain/api/v1/catalog?category=Energy&region=Europe&limit=10"

{
  "total": 47,
  "items": [
    {
      "id": "natgas_eu",
      "name": "Natural Gas (TTF, Europe)",
      "category": "Energy",
      "subcategory": "Natural Gas",
      "region": "Europe",
      "country": "",
      "source": "FRED",
      "unit": "$/MMBtu",
      "frequency": "M"
    },
    ...
  ],
  "filters": { "categories": [...], "regions": [...], "countries": [...] }
}

Get Index Data

GET /api/v1/series

Get time series data for a specific index.

Parameters

id	Index ID (from catalog)	string (required)
count	Number of data points (max 120, default 24)	number
format	Response format: "json" (default) or "csv" for Sheets =IMPORTDATA()	string

Using Google Sheets? See the live Sheets recipe for a one-line =IMPORTDATA() formula and Apps Script snippet.

Example

curl "https://your-domain/api/v1/series?id=copper&count=12"

{
  "id": "copper",
  "name": "Copper (LME)",
  "category": "Metals",
  "region": "Global",
  "country": "",
  "unit": "$/MT",
  "currentValue": 9245.50,
  "change1m": 2.3,
  "change3m": -1.5,
  "change12m": 8.7,
  "observations": [
    { "date": "2025-04-01", "value": 8510.25 },
    { "date": "2025-05-01", "value": 8672.10 },
    ...
  ]
}

Search FRED (800k+ Series)

GET /api/search?q=your+query

Search the full FRED database of 800,000+ economic data series. Returns series IDs you can use with the FRED API directly.

Rate Limits & Caching

All responses are cached for 1 hour server-side
CORS is enabled for all origins
No authentication required
Please be reasonable with request volume
Data sources: FRED (Federal Reserve), Eurostat (EU), World Bank, FAO