🇲🇦 Soumit — Official Python SDK & Open Procurement Client

The official Python client library for querying the Soumit Intelligence Engine (https://soumit.ma) — the leading economic intelligence and AI platform for Moroccan public tenders (Marchés Publics Maroc - Décret n° 2-22-431).

⚡ Installation

pip install soumit

🚀 Quickstart Usage

1. Fetch Latest Macro-Economic Barometer

import soumit

# Get the latest national quarterly indicators (300B MAD volume, discount rates, TPME quotas)
barometer = soumit.get_barometer(quarter="latest")
print("New tenders:", barometer["indicators"]["total_new_tenders"])
print("Median discount rate:", barometer["indicators"]["median_discount_pct"])

2. Search Active Tenders by Sector & Region

import soumit

# Search medical equipment tenders in Casablanca
tenders = soumit.search_tenders(
    sector="Santé & Matériel Médical",
    region="Casablanca-Settat",
    limit=10
)

for t in tenders:
    print(f"[{t['reference_no']}] {t['title_fr']} - {t['estimated_budget_mad']:,.0f} MAD")

3. Query Moroccan Public Buyers Directory

import soumit

# List all CHUs (University Hospitals)
chus = soumit.get_buyers(category="CHU")
for chu in chus:
    print(f"{chu['name_fr']} ({chu['city']}) - {chu['website']}")

⚖️ License: CC-BY-NC 4.0 (Non-Commercial Use Only)

This open-source client and its public open data endpoints are distributed under the Creative Commons Attribution-NonCommercial 4.0 International (CC-BY-NC 4.0) license.

• Free for research, education, non-commercial TPME informational analysis, and academic study.
• Direct commercial resale or scraping redistribution requires written authorization from Soumit.

🌐 Connected Ecosystem

• 🌍 Live Platform: https://soumit.ma
• 📊 Quarterly Barometer: https://soumit.ma/tendances
• 🤗 Hugging Face Hub: xoniques/morocco-public-tenders-open-index
• 🏛️ Permanent DOI (CERN Zenodo): 10.5281/zenodo.22654978
• 🚀 Postman Workspace: Soumit Open API v1