REST API
Automate websites, crawls and files with API keys.
Create an API key under API Access. Send it as a bearer token:
curl -H "Authorization: Bearer bra_live_..." https://app.blograinbow.com/api/v1/websites
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/websites | List your websites (paginated: ?page=&per_page=) |
| POST | /api/v1/websites | Add a website {"url": "example.com"} |
| GET | /api/v1/websites/:id | Website details |
| DELETE | /api/v1/websites/:id | Delete a website and its data |
| POST | /api/v1/websites/:id/verify | Run ownership verification |
| POST | /api/v1/websites/:id/crawl | Start a crawl |
| GET | /api/v1/websites/:id/crawl-history | Recent crawl runs |
| GET | /api/v1/websites/:id/files | Latest generated files (?path=llms.txt for content) |
| POST | /api/v1/websites/:id/generate | Regenerate files from stored content |
| POST | /api/v1/websites/:id/publish | Publish a generation {"generationId": "..."} |
| GET | /api/v1/websites/:id/readiness | Readiness report |
| GET | /api/v1/public/:siteId/llms.txt | Published file (no auth) |
| GET | /api/v1/badges/:siteId.svg | Badge (no auth) |
Responses are JSON: {"data": ...} on success, {"error": {"code", "message"}} on failure. Requests are rate-limited per key (60 per minute). Full reference: see API_DOCUMENTATION.md in the project repository.