Monopigi

Quick Start

Get up and running with the Monopigi API in under 2 minutes.

1. Create an Account

Sign up for a free Monopigi account. The free tier includes 5 API requests per day — no credit card required.

2. Get Your API Key

After signing in, go to the API Tokens page in your dashboard and create a new token. Your key will look like:

mp_live_abc123def456...

3. Make Your First Request

List available data sources:

curl -H "Authorization: Bearer mp_live_YOUR_KEY" \
  "https://api.monopigi.com/v1/sources"

Browse documents from a specific source:

curl -H "Authorization: Bearer mp_live_YOUR_KEY" \
  "https://api.monopigi.com/v1/ted/documents?limit=5"

Search across all sources (Pro tier — Free tier can browse documents by source):

curl -H "Authorization: Bearer mp_live_YOUR_KEY" \
  "https://api.monopigi.com/v1/search?q=hospital+procurement&limit=5"

4. Install the Python SDK

For a better developer experience, install the official Python SDK:

pip install monopigi-sdk

Authenticate once via the CLI:

monopigi auth login mp_live_YOUR_KEY

Then use it in your code:

from monopigi import MonopigiClient

with MonopigiClient() as client:
    # List sources
    for src in client.sources():
        print(f"{src.name}: {src.status}")

    # Search across all sources
    results = client.search("hospital procurement")
    for doc in results.results:
        print(doc.title, doc.source)

Or use the CLI directly:

# Search across all sources
monopigi search "energy regulation"

# Browse a specific source
monopigi documents ted --limit 20

# Export to file
monopigi export diavgeia decisions.json --format json

# Check your usage
monopigi usage

5. Explore the Data

Check what's available:

# Platform statistics
monopigi stats

# List sources with status
monopigi sources

# Browse TED procurement notices
monopigi documents ted --limit 10

# Browse Diavgeia government decisions
monopigi documents diavgeia --limit 10 --since 2026-01-01

Next Steps