How to Search Federal Contracts

import requests

# your API key
API_KEY = "your_api_key_here"
BASE_URL = "https://api.northaxiumdata.ca/api/v1"
headers = {"X-API-Key": API_KEY}

# search contracts for a vendor
params = {
    "vendor": "Palantir",   # partial match — finds all Palantir entities
    "limit": 10,
}

response = requests.get(f"{BASE_URL}/contracts", headers=headers, params=params)
data = response.json()

print(f"Total contracts found: {data['meta']['total']}")
print()

for contract in data["data"]:
    print(f"Vendor:     {contract['vendor']}")
    print(f"Department: {contract['department']}")
    print(f"Value:      ${contract['value']:,.0f}")
    print(f"Date:       {contract['date']}")
    print(f"Method:     {contract['procurement_method']}")
    print("---")

params = {
    "department": "National Defence",   # partial match on department name
    "min_value": 1000000,               # contracts over $1M CAD
    "date_from": "2022-01-01",
    "date_to": "2024-12-31",
    "limit": 20,
}

response = requests.get(f"{BASE_URL}/contracts", headers=headers, params=params)
data = response.json()

total_value = sum(c["value"] for c in data["data"] if c.get("value"))
print(f"Found {data['meta']['total']} contracts — showing {len(data['data'])}")
print(f"Total value in result set: ${total_value:,.0f}")

# Step 1: browse vendors to find the exact source string
browse = requests.get(
    f"{BASE_URL}/vendors",
    headers=headers,
    params={"q": "Palantir"}
)
vendors = browse.json()["data"]

print("Matching vendors:")
for v in vendors:
    print(f"  {v['vendor']} — ${v['total_value']:,.0f} across {v['contract_count']} contracts")

# Step 2: use the exact string to get the full profile
exact_name = vendors[0]["vendor"]
profile_response = requests.get(
    f"{BASE_URL}/vendors/{exact_name}",
    headers=headers
)
profile = profile_response.json()["data"]

print(f"\nVendor profile: {profile['vendor']}")
print(f"Total value: ${profile['total_value']:,.0f}")
print(f"Contract count: {profile['contract_count']}")
print("\nTop departments:")
for dept in profile["departments"][:3]:
    print(f"  {dept['name']}: ${dept['total_value']:,.0f}")

params = {
    "group_by": "department",
    "limit": 10,
}

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

print("Top departments by total contract value:")
for i, row in enumerate(stats, 1):
    print(f"  {i}. {row['group_value']}: ${row['sum_value']:,.0f} ({row['record_count']} contracts)")