API Reference
Search titles
GET
/v1/searchPerforms normalized full-text search, then orders matches by text relevance, vote count, and title ID. Search input is normalized with Unicode NFKC, control characters are removed, and at most 20 letter-or-number tokens are used.
Authorization
bearer_auth AuthorizationBearer <token>
Send the complete generated API key in Authorization: Bearer <key>. Valid key strings begin with mov_live_ and contain at least 43 URL-safe base64 characters after the prefix.
In: header
Query Parameters
q*string
Search text. After normalization it must contain at least one letter or number.
Length
1 <= length <= 100type?string
Exact normalized title type.
Value in
- "movie"
- "tv_movie"
- "tv_series"
- "tv_mini_series"
- "tv_special"
year?integer
Exact start year.
Range
1800 <= value <= 2100page?integer
One-based page number. Pages beyond the result set return an empty data array.
Range
1 <= value <= 1000000Default
1limit?integer
Results per page.
Range
1 <= value <= 20Default
20Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl "https://api.swipeformovie.com/v1/search?q=matrix&type=movie&year=1999&page=1&limit=20" \ -H "Authorization: Bearer $SWIPEFORMOVIE_API_KEY"{ "data": [ { "id": 1, "imdb_id": "tt0133093", "type": "movie", "title": "The Matrix", "original_title": "The Matrix", "year": 1999, "end_year": null, "runtime_minutes": 136, "genres": [ "Action", "Sci-Fi" ], "content_rating": "R", "plot": "A computer hacker learns that the world he knows is a simulated reality.", "languages": [ "English" ], "countries": [ "United States" ], "directors": [ "Lana Wachowski", "Lilly Wachowski" ], "writers": [ "Lilly Wachowski", "Lana Wachowski" ], "actors": [ "Keanu Reeves", "Laurence Fishburne", "Carrie-Anne Moss" ], "awards": "Won 4 Academy Awards.", "poster_url": "https://images.example.com/poster.jpg", "box_office": "$172,076,928", "production": null, "total_seasons": null, "ratings": { "average": 8.7, "votes": 2200000 } } ], "meta": { "request_id": "req_01J7EXAMPLE", "page": 1, "per_page": 20, "total_results": 2, "total_pages": 1 }}