API Documentation

Programmatic access to the llms.services AI Visibility Toolkit.

Getting Started

  1. Create an account at llms.services if you haven't already.
  2. Generate credentials: Go to your Account dashboard, navigate to API Keys, and generate a new key pair.
  3. Make requests: Use your new API key and secret in the Authorization header.

Authentication

The API uses Bearer token authentication. Your credentials consist of a key and a secret separated by a colon. Keys always begin with llms_k_ and secrets with llms_s_.

Authorization: Bearer <api_key>:<api_secret>

Keep your secret secure. Do not expose it in client-side code or public repositories.

Base URL

All API requests should be prefixed with the following base URL:

https://llms.services/_api/v1

Endpoints Reference

Error Codes

CodeStatusMeaning
400Bad RequestMissing required parameters or malformed JSON body.
401UnauthorizedInvalid API key or secret. Ensure the Authorization header is correct.
402Payment RequiredInsufficient credit balance to run the scan.
404Not FoundThe requested resource (e.g., site or scan) does not exist.
500Internal Server ErrorSomething went wrong on our end. Please try again later.

Usage Policy

There are no hard rate limits on API requests. Your usage is governed entirely by your credit balance — as long as you have credits, you can make requests.

  • Scanning endpoints deduct credits based on pages crawled and files generated.
  • Read-only endpoints (status, results, sites, balance, schedules) are free.
Note: The free llms.txt generation available on the web app does not apply to API access. All API scans require credits regardless of file types selected.

Credits & Billing

While llms.txt can be generated for free via the web dashboard (up to 3 scans/day, 1 domain), API access always requires credits for all scan types. Triggering a scan via /v1/scan/start deducts credits from your account balance.

If your balance is insufficient, a 402 Payment Required error is returned. You can top up by visiting the Pricing page.

Enterprise & Custom Needs

Need higher throughput, dedicated support, or custom integrations? We offer tailored enterprise plans for teams and agencies.

Contact us at support@llms.services