Quickstart

curl "https://api.aisearchapi.dev/v1/search?view=flat" \
  -H "Authorization: Bearer $AISEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best crm for startups",
    "surfaces": ["chatgpt"]
  }'

const res = await fetch("https://api.aisearchapi.dev/v1/search?view=flat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AISEARCH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "best crm for startups",
    surfaces: ["chatgpt"],
  }),
});

const result = await res.json();
console.log(result.text); // the answer ChatGPT actually rendered

import os, requests

res = requests.post(
    "https://api.aisearchapi.dev/v1/search?view=flat",
    headers={
        "Authorization": f"Bearer {os.environ['AISEARCH_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "query": "best crm for startups",
        "surfaces": ["chatgpt"],
    },
)

print(res.json()["text"])

PARENT="job_8t2q"

while true; do
  BODY=$(curl -s "https://api.aisearchapi.dev/v1/jobs/$PARENT" \
    -H "Authorization: Bearer $AISEARCH_API_KEY")
  STATUS=$(echo "$BODY" | jq -r '.job.status')
  echo "status: $STATUS"
  case "$STATUS" in
    completed|partial|failed|canceled|expired)
      # fetch each child's Envelope
      echo "$BODY" | jq -r '.children[].id' | while read -r CHILD; do
        curl -s "https://api.aisearchapi.dev/v1/jobs/$CHILD" \
          -H "Authorization: Bearer $AISEARCH_API_KEY" | jq '.answer.text'
      done
      break ;;
  esac
  sleep 2
done

const TERMINAL = ['completed', 'partial', 'failed', 'canceled', 'expired'];
const headers = { Authorization: `Bearer ${process.env.AISEARCH_API_KEY}` };

async function waitForParent(parentId) {
  while (true) {
    const res = await fetch(
      `https://api.aisearchapi.dev/v1/jobs/${parentId}`,
      { headers },
    );
    const { job, children } = await res.json();
    console.log('status:', job.status);
    if (TERMINAL.includes(job.status)) return children;
    await new Promise((r) => setTimeout(r, 2000));
  }
}

const children = await waitForParent('job_8t2q');
for (const child of children) {
  const env = await (
    await fetch(`https://api.aisearchapi.dev/v1/jobs/${child.id}`, { headers })
  ).json();
  console.log(child.surface, child.region, env.answer.text);
}

import os, time, requests

TERMINAL = {"completed", "partial", "failed", "canceled", "expired"}
headers = {"Authorization": f"Bearer {os.environ['AISEARCH_API_KEY']}"}

def wait_for_parent(parent_id, interval=2.0):
    while True:
        body = requests.get(
            f"https://api.aisearchapi.dev/v1/jobs/{parent_id}",
            headers=headers,
        ).json()
        print("status:", body["job"]["status"])
        if body["job"]["status"] in TERMINAL:
            return body["children"]
        time.sleep(interval)

for child in wait_for_parent("job_8t2q"):
    env = requests.get(
        f"https://api.aisearchapi.dev/v1/jobs/{child['id']}",
        headers=headers,
    ).json()
    print(child["surface"], child["region"], env["answer"]["text"])