OPEC Production

Monthly OPEC production data from the Official OPEC Monthly Oil Market Report (MOMR).

Source: OPEC Monthly Oil Market Report Release: Around the 15th of each month Tier Required: Reservoir Mastery

Endpoints

MethodEndpointDescription
GET/v1/dark_data/opec_productionsList paginated reports
GET/v1/dark_data/opec_productions/latestLatest report
GET/v1/dark_data/opec_productions/totalOPEC total production trend
GET/v1/dark_data/opec_productions/by_countryFilter by country
GET/v1/dark_data/opec_productions/historicalHistorical data
GET/v1/dark_data/opec_productions/top_producersRanked producers list
GET/v1/dark_data/opec_productions/:idSpecific report by ID

List Reports

GET /v1/dark_data/opec_productions

Parameters

ParameterTypeDefaultDescription
pageinteger1Page number
per_pageinteger10Results per page (max 50)

Latest Report

GET /v1/dark_data/opec_productions/latest

Response

{
  "data": {
    "report_month": "2024-12",
    "opec_total_mbpd": 27.84,
    "month_over_month": -0.15,
    "headline": "OPEC production decreased by 150,000 b/d in December",
    "countries": [
      {
        "country": "saudi_arabia",
        "name": "Saudi Arabia",
        "production_mbpd": 9.13,
        "quota_mbpd": 9.00,
        "compliance_pct": 98.6
      }
    ]
  }
}

Total Production Trend

GET /v1/dark_data/opec_productions/total

Parameters

ParameterTypeDefaultDescription
monthsinteger12Months of history (max 60)

Response

{
  "data": {
    "latest": {
      "report_month": "2024-12",
      "production_mbpd": 27.84,
      "month_over_month": -0.15
    },
    "history": [
      {
        "report_month": "2024-12",
        "production_mbpd": 27.84
      },
      {
        "report_month": "2024-11",
        "production_mbpd": 27.99
      }
    ],
    "trend": {
      "direction": "decreasing",
      "change_mbpd": -0.65,
      "change_pct": -2.3
    }
  }
}

By Country

GET /v1/dark_data/opec_productions/by_country

Parameters

ParameterTypeRequiredDescription
countrystringNoCountry code (snake_case)
monthstringNoFormat: YYYY-MM

OPEC Countries

CodeCountry
algeriaAlgeria
angolaAngola
congoCongo
equatorial_guineaEquatorial Guinea
gabonGabon
iranIran
iraqIraq
kuwaitKuwait
libyaLibya
nigeriaNigeria
saudi_arabiaSaudi Arabia
uaeUnited Arab Emirates
venezuelaVenezuela

OPEC+ Countries (Additional)

CodeCountry
azerbaijanAzerbaijan
bahrainBahrain
bruneiBrunei
kazakhstanKazakhstan
malaysiaMalaysia
mexicoMexico
omanOman
russiaRussia
south_sudanSouth Sudan
sudanSudan

Response

{
  "data": {
    "report_month": "2024-12",
    "country": "saudi_arabia",
    "name": "Saudi Arabia",
    "production_mbpd": 9.13,
    "quota_mbpd": 9.00,
    "compliance_pct": 98.6,
    "spare_capacity_mbpd": 3.0,
    "month_over_month": 0.05
  }
}

Top Producers

GET /v1/dark_data/opec_productions/top_producers

Parameters

ParameterTypeDefaultDescription
limitinteger10Number of producers (max 20)
monthstringlatestFormat: YYYY-MM

Response

{
  "data": {
    "report_month": "2024-12",
    "producers": [
      {
        "rank": 1,
        "country": "saudi_arabia",
        "name": "Saudi Arabia",
        "production_mbpd": 9.13,
        "month_over_month": 0.05,
        "share_of_opec": 32.8
      },
      {
        "rank": 2,
        "country": "iraq",
        "name": "Iraq",
        "production_mbpd": 4.25,
        "month_over_month": -0.10,
        "share_of_opec": 15.3
      }
    ],
    "opec_total": 27.84
  }
}

Historical

GET /v1/dark_data/opec_productions/historical

Parameters

ParameterTypeDefaultDescription
countrystringopec_totalCountry code or opec_total
monthsinteger24Months of data (max 120)

Response

{
  "data": {
    "country": "saudi_arabia",
    "data_points": [
      {
        "report_month": "2024-12",
        "production_mbpd": 9.13,
        "quota_mbpd": 9.00
      }
    ]
  }
}

Code Examples

Python - Compliance Tracking

import requests

response = requests.get(
    "https://api.oilpriceapi.com/v1/dark_data/opec_productions/latest",
    headers={"Authorization": "Token YOUR_API_KEY"}
)
data = response.json()

print(f"OPEC Total: {data['data']['opec_total_mbpd']} mb/d")

for country in data['data']['countries']:
    if country.get('compliance_pct'):
        status = "OK" if country['compliance_pct'] >= 100 else "OVER"
        print(f"{country['name']}: {country['compliance_pct']}% compliance [{status}]")

JavaScript - Production Trend

const response = await fetch(
  "https://api.oilpriceapi.com/v1/dark_data/opec_productions/total?months=6",
  { headers: { "Authorization": "Token YOUR_API_KEY" } }
);
const data = await response.json();

const trend = data.data.trend;
console.log(`OPEC Trend: ${trend.direction}`);
console.log(`Change: ${trend.change_mbpd} mb/d (${trend.change_pct}%)`);

Why OPEC Production Matters

  • Supply Control: OPEC+ controls ~40% of global oil supply
  • Quota Compliance: Actual vs target production affects prices
  • Spare Capacity: Saudi spare capacity is market safety valve
  • Geopolitics: Sanctions, conflicts affect production
Last Updated: