API Documentation

Integrate LLMS Central into your AI training pipeline with our comprehensive RESTful API.

Quick Start

Get started with the LLMS Central API in minutes. All endpoints are RESTful and return JSON responses.

Base URL:

https://llmscentral.com/api

Authentication

Most read endpoints are public and don't require authentication. Rate limiting applies to all endpoints.

Rate Limits:

• Read endpoints (/api/search, /api/llms, /api/stats): 100 requests/hour per IP
• Submit endpoint (/api/submit): 5 submissions/hour per IP
• Direct file access (/{domain}/llms.txt): No rate limit

API Endpoints

GET/api/search

Search for domains with llms.txt files by query, category, or content type.

Query Parameters:

Parameter	Type	Description
`q`	string	Search query for domain names or content
`category`	string	Filter by category (blog, news, ecommerce, etc.)
`limit`	number	Number of results to return (max 100)

Example Request:

GET /api/search?q=blog&category=technology&limit=10

Example Response:

{
  "results": [
    {
      "domain": "example.com",
      "lastUpdated": "2025-09-26T21:54:43Z",
      "categories": ["blog", "technology"],
      "contentTypeTags": ["articles", "tutorials"],
      "validationStatus": "valid"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10
}

GET/api/llms

Retrieve the llms.txt content for a specific domain.

Query Parameters:

Parameter	Required	Description
`domain`	Yes	The domain name to retrieve llms.txt for

Example Request:

GET /api/llms?domain=example.com

GET/api/stats

Get platform statistics including total domains, categories, and usage metrics.

Example Response:

{
  "totalDomains": 1250,
  "validDomains": 1180,
  "totalRequests": 45230,
  "categoriesCount": 15,
  "lastUpdated": "2025-09-26T21:54:43Z"
}

POST/api/submit

Submit a new domain to the LLMS Central repository. Requires domain ownership verification.

Request Body:

{
  "domain": "example.com",
  "email": "owner@example.com",
  "categories": ["blog", "technology"],
  "contentTypes": ["articles", "tutorials"]
}

Response:

{
  "success": true,
  "message": "Domain submitted successfully",
  "domainId": "abc123",
  "verificationRequired": true,
  "nextSteps": "Check your email for verification instructions"
}

Rate Limit: 5 submissions per hour per IP address.

GET/{domain}/llms.txt

Direct access to llms.txt files, similar to robots.txt. This is the standard way to access llms.txt files.

Example Request:

GET /example.com/llms.txt

Response Headers:

`Content-Type`	text/plain; charset=utf-8
`Cache-Control`	public, max-age=3600
`X-LLMS-Central-Version`	File version number

Error Handling

The API uses standard HTTP status codes and returns error details in JSON format.

Common Status Codes:

200 - Success
400 - Bad Request (invalid parameters)
404 - Not Found (domain not in repository)
429 - Too Many Requests (rate limited)
500 - Internal Server Error

SDKs and Libraries

Official and community-maintained libraries for popular programming languages.

Official SDKs

• Python SDK (coming soon)
• Node.js SDK (coming soon)
• Go SDK (coming soon)

Community Libraries

• Rust crate (community)
• PHP package (community)
• Java library (community)