Agent quickstart

curl -X POST "https://api.newscatcherapi.com/agent/runs" \
  -H "x-api-key: $NEWSCATCHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Bank M&A deals announced in the US since Sep 15",
    "mode": "fast",
    "max_rows": 50
  }'

{ "run_id": "RUN_ID", "status": "queued", "kind": "events" }

import os
import time
import requests

BASE = "https://api.newscatcherapi.com/agent"
HEADERS = {"x-api-key": os.environ["NEWSCATCHER_API_KEY"]}

run = requests.post(
    f"{BASE}/runs",
    headers=HEADERS,
    json={"query": "Bank M&A deals announced in the US since Sep 15", "mode": "fast"},
).json()

while True:
    detail = requests.get(f"{BASE}/runs/{run['run_id']}", headers=HEADERS).json()
    if detail["status"] not in ("queued", "running"):
        break
    time.sleep(15)

if detail["status"] != "succeeded":
    raise RuntimeError(detail.get("error"))
print(detail["columns"])
for row in detail["rows"]:
    print(row)

curl -o deals.csv "https://api.newscatcherapi.com/agent/runs/RUN_ID/export.csv" \
  -H "x-api-key: $NEWSCATCHER_API_KEY"

curl -X POST "https://api.newscatcherapi.com/agent/monitors" \
  -H "x-api-key: $NEWSCATCHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "dataset", "from_run_id": "RUN_ID", "schedule": {"every": "week"}}'