Skip to content
BlogRainbow AI Ready

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
MethodEndpointDescription
GET/api/v1/websitesList your websites (paginated: ?page=&per_page=)
POST/api/v1/websitesAdd a website {"url": "example.com"}
GET/api/v1/websites/:idWebsite details
DELETE/api/v1/websites/:idDelete a website and its data
POST/api/v1/websites/:id/verifyRun ownership verification
POST/api/v1/websites/:id/crawlStart a crawl
GET/api/v1/websites/:id/crawl-historyRecent crawl runs
GET/api/v1/websites/:id/filesLatest generated files (?path=llms.txt for content)
POST/api/v1/websites/:id/generateRegenerate files from stored content
POST/api/v1/websites/:id/publishPublish a generation {"generationId": "..."}
GET/api/v1/websites/:id/readinessReadiness report
GET/api/v1/public/:siteId/llms.txtPublished file (no auth)
GET/api/v1/badges/:siteId.svgBadge (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.