API Documentation

Cinema Scraper AI REST API Reference

← Back to Home

Overview

The Cinema Scraper API provides programmatic access to extract movie showtimes from cinema websites worldwide. Our AI-powered system adapts to any cinema website structure automatically.

Base URL: https://cinema-scraper-ai.workers.dev/api

Authentication: Contact admin for API key access

Public Endpoints

GET /health

Check API health status

Response

{
  "status": "healthy",
  "timestamp": "2024-01-01T00:00:00Z"
}
POST /api/discover

Analyze a cinema website and create extraction blueprint

Request Body

url string - Cinema website URL to analyze

Response

{
  "success": true,
  "analysis": {
    "siteName": "IFC Center",
    "discoveryMethod": "sitemap",
    "movieLinksFound": 25,
    "recommendedStrategy": "DIRECT_AI"
  }
}
GET /api/extract

Extract showtimes from a cinema website

Query Parameters

url string - Cinema website URL
pageType string - Optional page type hint (homepage, movie-detail, etc.)

Response

{
  "success": true,
  "cinemaName": "IFC Center",
  "movies": [
    {
      "title": "Example Movie",
      "showtimes": [
        {
          "date": "2024-01-01",
          "time": "7:30 PM",
          "bookingUrl": "https://..."
        }
      ]
    }
  ],
  "extractionTime": 1234
}

Admin Endpoints

All admin endpoints require authentication via Bearer token in the Authorization header.

Authorization: Bearer YOUR_TOKEN

Blueprints

GET /api/admin/blueprints

List all extraction blueprints

GET /api/admin/blueprints/:id

Get specific blueprint details

Discovery Queue

POST /api/admin/discovery-queue

Add cinema to discovery queue

Audit

GET /api/admin/audit

Audit and extract from cinema website

Rate Limits

API requests are rate limited to ensure fair usage:

Error Codes

The API uses standard HTTP response codes: