{
  "page": "docs/public-data",
  "title": "Public data and formats",
  "slug": "public-data",
  "description": "The no-key endpoints, the Markdown and JSON copy of every page, the discovery files, and the licence.",
  "section": "Reference",
  "updated": "2026-09-30",
  "blocks": [
    {
      "type": "p",
      "text": "Scores, prices, pass rules and benchmark reports are public: no key, no sign-up. Every public response is published under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/) and carries `license` and `generated_at`. Use it anywhere with the attribution \"Arettic (arettic.com)\"."
    },
    {
      "type": "h2",
      "id": "endpoints",
      "text": "No-key endpoints"
    },
    {
      "type": "table",
      "caption": "Base URL https://api.arettic.com",
      "head": [
        "Endpoint",
        "Query",
        "What it returns"
      ],
      "rows": [
        [
          "`GET /v1/task-types`",
          "—",
          "The task types, each with its pass rule, input and output fields."
        ],
        [
          "`GET /v1/tools`",
          "`task_type`, `region`, `mode=test`",
          "The tool catalog with scores and prices. `mode=test` lists the mock tools test keys buy."
        ],
        [
          "`GET /v1/tools/{id}`",
          "—",
          "One tool: its score per region, every score input, the weekly history, the latest benchmark and its price."
        ],
        [
          "`GET /v1/scores`",
          "`task_type`, `region`, `mode=test`",
          "The current score of every tool."
        ],
        [
          "`GET /v1/pricing`",
          "—",
          "The price per success of every tool, per plan."
        ],
        [
          "`GET /v1/formula`",
          "—",
          "The score formula, weights, inputs and rules, the pass rules and the price formula. See [how scores work](/docs/scores)."
        ],
        [
          "`GET /v1/reports`",
          "—",
          "The published benchmark reports."
        ],
        [
          "`GET /v1/reports/{slug}`",
          "—",
          "One report: ranked results, method and sample cases."
        ],
        [
          "`GET /v1/status`",
          "—",
          "Live status of the API, execute, recommend, MCP, website and payments, with incidents."
        ],
        [
          "`POST /v1/waitlist`",
          "body: `email` (required), `name`, `company`, `use_case`",
          "Join the waitlist. 201 `joined`, 200 `already_joined`."
        ]
      ]
    },
    {
      "type": "list",
      "items": [
        "Responses are cacheable for 60 seconds (`Cache-Control: public, max-age=60`) and allow any origin (`Access-Control-Allow-Origin: *`), so a browser page can call them directly.",
        "Limit: 120 requests a minute per IP, reported in `RateLimit-*` headers. See [rate limits](/docs/rate-limits).",
        "An unknown `task_type` gets `unknown_task_type`; an unknown tool, `404 unknown_tool`."
      ]
    },
    {
      "type": "code",
      "title": "curl",
      "lang": "bash",
      "code": "curl \"https://api.arettic.com/v1/tools?task_type=find_email&region=US\"\ncurl https://api.arettic.com/v1/tools/zerobounce-verify-email"
    },
    {
      "type": "code",
      "title": "TypeScript",
      "lang": "ts",
      "code": "import { Arettic } from \"@arettic/sdk\";\n\nconst arettic = new Arettic(); // public calls need no key\nconst { tools } = await arettic.tools({ taskType: \"verify_email\", region: \"US\" });\nconst formula = await arettic.formula();"
    },
    {
      "type": "code",
      "title": "Python",
      "lang": "python",
      "code": "from arettic import Arettic\n\nclient = Arettic()  # public calls need no key\ntools = client.tools(task_type=\"verify_email\", region=\"US\")[\"tools\"]\nformula = client.formula()"
    },
    {
      "type": "h2",
      "id": "page-copies",
      "text": "Every page as Markdown and JSON"
    },
    {
      "type": "p",
      "text": "Every public page of the site (home, pricing, scores, each tool, each report, these docs, the changelog, status) has two machine-readable copies with the same content:"
    },
    {
      "type": "list",
      "items": [
        "Add `.md` or `.json` to the path: `https://arettic.com/docs/quickstart.md`, `https://arettic.com/tools/zerobounce-verify-email.json`. The home page is `/index.md` and `/index.json`.",
        "Or keep the path and send `Accept: text/markdown` or `Accept: application/json`.",
        "Each HTML page also names its copies in `<link rel=\"alternate\">` tags."
      ]
    },
    {
      "type": "code",
      "title": "curl",
      "lang": "bash",
      "code": "curl https://arettic.com/docs/receipts.md\ncurl -H \"Accept: application/json\" https://arettic.com/pricing"
    },
    {
      "type": "h2",
      "id": "discovery",
      "text": "Discovery files"
    },
    {
      "type": "table",
      "caption": "For agents and crawlers",
      "head": [
        "File",
        "What it is"
      ],
      "rows": [
        [
          "`/llms.txt`",
          "A short map of the site and the API for language models, with links to the Markdown copies."
        ],
        [
          "`/llms-full.txt`",
          "The same, with the full docs inline."
        ],
        [
          "`/openapi.json`",
          "The OpenAPI 3.1 description of every endpoint (also on the API's domain)."
        ],
        [
          "`/.well-known/mcp.json`",
          "The MCP server card: endpoint, transport and tools."
        ],
        [
          "`/schemas/{name}.json`",
          "Open JSON Schemas: receipt, execute request and response, webhook event, pass rules."
        ],
        [
          "`/sitemap.xml`",
          "Every public page."
        ],
        [
          "`/robots.txt`",
          "AI crawlers and agents are welcome; only the dashboard and sign-in paths are closed."
        ],
        [
          "`/changelog.xml`",
          "The changelog as RSS; also `/changelog.md` and `/changelog.json`."
        ],
        [
          "`/status.json`",
          "The status page as JSON; also `/status.md`."
        ]
      ]
    }
  ]
}