Quickstart

This walkthrough creates a generation for a brand-new site, polls until it's done, and downloads each artifact.

1. Kick off a generation

curl -X POST https://www.aiready.cat/api/v1/generations \
  -H "Authorization: Bearer mklt_pat_..." \
  -H "content-type: application/json" \
  -d '{ "name": "Acme", "rootUrl": "https://acme.test" }'

Response:

{
  "generation": {
    "id": "0190f8a1-c0c0-4000-8000-aaaaaaaaaaaa",
    "siteId": "0190f8a1-c0c0-4000-8000-bbbbbbbbbbbb",
    "status": "pending",
    "trigger": "manual",
    "createdAt": "...",
    "urls": {
      "self": "https://www.aiready.cat/api/v1/generations/0190f8a1-c0c0-4000-8000-aaaaaaaaaaaa",
      "llms": ".../llms.txt",
      "llmsFull": ".../llms-full.txt",
      "pages": ".../pages"
    }
  }
}

2. Poll until ready

curl -H "Authorization: Bearer mklt_pat_..." \
  https://www.aiready.cat/api/v1/generations/0190f8a1-c0c0-4000-8000-aaaaaaaaaaaa

Repeat until status is "succeeded" (or "failed").

3. Download

curl -H "Authorization: Bearer mklt_pat_..." \
  https://www.aiready.cat/api/v1/generations/0190f8a1-c0c0-4000-8000-aaaaaaaaaaaa/llms.txt

For per-page markdown, hit /pages first to see the manifest, then /pages/<path> for any page.

Next steps

  • See Citation Audits to score how well each page is set up to be cited by AI engines.

On this page