API Overview
Blockbusterr provides a comprehensive RESTful API for managing jobs, viewing activity, and previewing content.
Base URL
Section titled “Base URL”http://localhost:9090/v1Replace localhost:9090 with your Blockbusterr instance URL.
Response Format
Section titled “Response Format”All endpoints return JSON unless otherwise specified.
Success Response:
{ "data": { ... }, "count": 10}Error Response:
{ "error": "Error message here"}Status Codes
Section titled “Status Codes”| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request - Invalid parameters |
| 404 | Not Found - Resource doesn’t exist |
| 500 | Internal Server Error |
Authentication
Section titled “Authentication”Currently, no authentication is required for API access.
Rate Limiting
Section titled “Rate Limiting”Currently, no rate limiting is enforced. Please use the API responsibly.
API Sections
Section titled “API Sections”Manage and trigger jobs, preview content before adding.
- Preview jobs
- Trigger jobs manually
- Get job status
View and manage activity logs.
- Get activity logs
- Get activity statistics
- Clear old logs
Manage integrations and test connections.
- Validate Radarr/Sonarr connections
- Get quality profiles and root folders
- Fetch metadata (genres, countries, languages)
Quick Examples
Section titled “Quick Examples”Preview a Job
Section titled “Preview a Job”curl -X POST http://localhost:9090/v1/jobs/preview/trending-moviesTrigger a Job
Section titled “Trigger a Job”curl -X POST http://localhost:9090/v1/jobs/trigger/popular-showsGet Recent Activity
Section titled “Get Recent Activity”curl "http://localhost:9090/v1/activity/logs?limit=50"Get Trending Movies from Trakt
Section titled “Get Trending Movies from Trakt”curl "http://localhost:9090/v1/trakt/trending/movies?limit=10"Next Steps
Section titled “Next Steps”- Explore Jobs API
- Check Activity API
- Review Configuration API