Python

import os
import httpx

BASE_URL = os.environ["ORBIT_BASE_URL"]
API_KEY = os.environ["ORBIT_API_KEY"]

def search_interests(query: str, category: str | None = None) -> dict:
    params = {"q": query, "limit": 20}
    if category:
        params["category"] = category

    with httpx.Client(timeout=5.0) as client:
        response = client.get(
            f"{BASE_URL}/v1/interests/search",
            params=params,
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        response.raise_for_status()
        return response.json()

def resolve_interests(ids: list[str]) -> dict:
    with httpx.Client(timeout=5.0) as client:
        response = client.post(
            f"{BASE_URL}/v1/interests/resolve",
            json={"ids": ids},
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        response.raise_for_status()
        return response.json()