Getting Started

1. Get an API key

Sign in through the existing SwipeForMovie application, then open your account dashboard. The documentation site does not have its own account or authentication system.

2. Keep the key on your server

Store the complete key in an environment variable. Do not commit it or expose it in browser code.

SWIPEFORMOVIE_API_KEY=mov_live_replace_with_your_key

3. Call the API

All authenticated endpoints use the production base URL https://api.swipeformovie.com and an Authorization header with the exact Bearer scheme implemented by the API.

curl "https://api.swipeformovie.com/v1/search?q=matrix&type=movie" \
  -H "Authorization: Bearer $SWIPEFORMOVIE_API_KEY"

4. Read the envelope

Successful responses contain a data array and meta object. A search response looks like this:

{
  "data": [
    {
      "id": 1,
      "imdb_id": "tt0133093",
      "type": "movie",
      "title": "The Matrix",
      "year": 1999,
      "ratings": { "average": 8.7, "votes": 2200000 }
    }
  ],
  "meta": {
    "request_id": "req_01J7EXAMPLE",
    "page": 1,
    "per_page": 20,
    "total_results": 2,
    "total_pages": 1
  }
}

The complete title object includes nullable metadata fields documented in the response schema.

Next steps

• Learn how API keys are sent in Authentication.
• Handle 429 responses with Rate Limits.
• Iterate through results with Pagination.