The academic search and citation API

curl -X POST https://api.sourcely.net/search \
  -H "Authorization: Bearer $SOURCELY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"text":"How do urban green spaces affect mental health?","mode":"quick","citation_formats":["apa7"]}'

# 202 Accepted: { "job_id": "src_example", "status": "queued" }

curl https://api.sourcely.net/search/src_example \
  -H "Authorization: Bearer $SOURCELY_API_KEY"

import os, time, httpx

headers = {"Authorization": f"Bearer {os.environ['SOURCELY_API_KEY']}"}
body = {
    "text": "How do urban green spaces affect mental health?",
    "mode": "quick",
    "citation_formats": ["apa7"],
}

with httpx.Client(base_url="https://api.sourcely.net", headers=headers, timeout=180) as client:
    job_id = client.post("/search", json=body).raise_for_status().json()["job_id"]
    while (result := client.get(f"/search/{job_id}").json())["status"] not in ("completed", "failed"):
        time.sleep(2)

for source_id in (result.get("document") or {}).get("source_ids", []):
    print(result["sources"][source_id]["title"])

const headers = {
  Authorization: `Bearer ${process.env.SOURCELY_API_KEY}`,
  "Content-Type": "application/json",
};
const api = "https://api.sourcely.net";

const { job_id } = await (await fetch(`${api}/search`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    text: "How do urban green spaces affect mental health?",
    mode: "quick",
    citation_formats: ["apa7"],
  }),
})).json();

let result;
do {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  result = await (await fetch(`${api}/search/${job_id}`, { headers })).json();
} while (!["completed", "failed"].includes(result.status));

for (const id of result.document?.source_ids ?? []) {
  console.log(result.sources[id].title);
}