Skip to main content

1. Get your API key

Sign up at platform.getdatagate.com and generate an API key from the dashboard. Your key starts with dg_live_.

2. Install the SDK

pip install datagate

3. Discover datasets

from datagate import DatagateClient

client = DatagateClient(api_key="dg_live_...")

datasets = await client.list_datasets()
for ds in datasets:
    print(f"{ds.name}{ds.price_per_chunk} {ds.currency}/chunk")
    if ds.metadata_schema:
        for field in ds.metadata_schema:
            print(f"  Filter: {field['name']} ({field['type']})")

4. Query

response = await client.query(
    text="machine learning transformers",
    dataset_ids=[ds.id for ds in datasets if ds.queryable],
    top_k=5,
)

for result in response.results:
    print(f"[{result.score:.4f}] {result.metadata}")

await client.close()

5. Add filters (optional)

Use metadata_schema from step 3 to filter results per dataset:
response = await client.query(
    text="privacy regulations",
    dataset_ids=["ds-aaa", "ds-bbb"],
    filters={
        "ds-aaa": {"year": {"$gte": 2023}},
        "ds-bbb": {"category": {"$eq": "legal"}},
    },
)

Next steps