Skip to main content

Python Examples

Setup

import requests

API_KEY = "mk_live_your_key_here"
BASE_URL = "https://api.maverickintelligence.co"
HEADERS = {"X-API-Key": API_KEY}

List all people (with pagination)

def get_all_people():
    """Fetch all people by paginating through all pages."""
    people = []
    cursor = None

    while True:
        params = {"limit": 100}
        if cursor:
            params["cursor"] = cursor

        response = requests.get(
            f"{BASE_URL}/v1/people",
            headers=HEADERS,
            params=params,
        )
        response.raise_for_status()
        data = response.json()

        people.extend(data["data"])

        cursor = data["pagination"].get("nextCursor")
        if not cursor:
            break

    return people

people = get_all_people()
print(f"Total people: {len(people)}")

Get hot leads only

response = requests.get(
    f"{BASE_URL}/v1/people",
    headers=HEADERS,
    params={"hot_leads_only": "true", "limit": 50},
)
hot_leads = response.json()["data"]

for lead in hot_leads:
    print(f"{lead['firstName']} {lead['lastName']} - {lead['company']}")

Get people seen since yesterday

from datetime import datetime, timedelta

yesterday = (datetime.utcnow() - timedelta(days=1)).isoformat() + "Z"

response = requests.get(
    f"{BASE_URL}/v1/people",
    headers=HEADERS,
    params={"since": yesterday},
)
recent = response.json()["data"]
print(f"People seen since yesterday: {len(recent)}")

Get a person’s events

person_id = "abc123"
response = requests.get(
    f"{BASE_URL}/v1/people/{person_id}/events",
    headers=HEADERS,
    params={"limit": 100},
)
events = response.json()["data"]

for event in events:
    print(f"  {event['timestamp']} - {event['eventType']} - {event['url']}")

Get dashboard stats

response = requests.get(f"{BASE_URL}/v1/stats", headers=HEADERS)
stats = response.json()["data"]

print(f"Total people: {stats['totalPeople']}")
print(f"Total companies: {stats['totalCompanies']}")
print(f"Events (30d): {stats['recentEvents']}")