API Documentation
Complete guide to using the GZMovie API for streaming and downloading movies and series.
Getting Started
The GZMovie API provides a simple REST interface for searching, streaming, and downloading movies and TV series. All endpoints return JSON responses and support CORS for browser-based applications.
Base URL
https://your-domain.comAPI Key
GodszealFormat
JSONTable of Contents
API Endpoints
GET
/api/searchSearch for movies and TV series by title
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Search query (movie/series title) |
| subjectType | string | No | Filter by type: ALL, MOVIE, TV |
| page | number | No | Page number (default: 1) |
| perPage | number | No | Results per page (default: 24) |
Examples
GET
/api/item-detailsGet detailed information about a specific movie or series
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| subjectId | string | Yes | The unique subject ID |
Examples
GET
/api/mediaGet streaming and download links with proxied URLs
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| subjectId | string | Yes | The unique subject ID |
| detailPath | string | Yes | The detail path from item details |
| season | number | No | Season number for TV series (default: 0) |
| episode | number | No | Episode number for TV series (default: 0) |
Examples
POST
/api/streamGet streaming data for playback
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| subjectId | string | Yes | The unique subject ID |
| detailPath | string | Yes | The detail path |
| season | number | No | Season number (default: 0) |
| episode | number | No | Episode number (default: 0) |
Examples
GET
/api/proxyProxy streaming content to bypass CORS restrictions
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | The encoded URL to proxy |
Examples
GET
/api/proxy-downloadDownload media files with proper filename (name is required)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | The encoded URL to download |
| name | string | Yes | Movie/series name for filename (REQUIRED) |
| quality | string | No | Quality label (e.g., 1080p, 720p) |
Examples
Complete Workflow Example
Here is a complete example showing how to search for a movie and get its streaming/download links.