API Documentation
SPIDY Poster API
Fetch high-quality OTT poster metadata using movie names, TV show titles, seasons, years, or parsed filenames.
Authentication
Every request requires a valid API key passed as a URL query parameter (api_key).
GET /v1/fetch?api_key=YOUR_API_KEY&title=Asur
Search Endpoint
Main endpoint for searching movies and TV posters.
GET /v1/fetch
Movie Search
/v1/fetch?api_key=YOUR_KEY&title=RRR&year=2022
TV Season
/v1/fetch?api_key=YOUR_KEY&title=Asur&season=2
Filename Parsing
/v1/fetch?api_key=YOUR_KEY&query=Asur.S02.1080p.mkv
Query Parameters
| Parameter | Description | Example |
|---|---|---|
api_key |
Required. Your unique API key | abc123xyz |
title |
Movie or TV show title | Asur |
year |
Release year | 2022 |
season |
TV season number | 2 |
query |
Filename parser search | Asur.S02.1080p.mkv |
Response Example
{
"title": "Asur",
"year": 2023,
"type": "tv",
"season": "Season 2",
"poster": "https://...jpg",
"landscape": "https://...jpg"
}
Error Responses
| Status | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 404 | Poster not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |
Rate Limits
API usage is protected by request quotas and per-minute rate limits.
- Free Plan → 30 req/min
- Monthly Quota System → Resets 1st of every month
- Automatic Usage Tracking → View in dashboard
- Lifetime Analytics Support → Check past usage