Flix Recs API

How to Use the API

Use your API key to send a request and get AI-powered movie/show recommendations. You can customize the results based on genre, mood, runtime, rating, and more.

🎯 Want to limit by streaming platforms?
Just mention the platform in your query (e.g., "comedy shows on Netflix") or use the platform_only=true flag to restrict results exclusively to available platforms in your region (set by user_country).

Example Prompt: John Wick but as a female

📌 Example Request (GET) – Using JavaScript Fetch:

  fetch('https://flix-api-b.onrender.com/recommend?query=John%20Wick%20but%20with%20a%20female%20lead&platform_only=false&user_country=US', {
    method: 'GET',
    headers: {
      'X-API-KEY': 'your_api_key_here'
    }
  })
  .then(response => response.json())
  .then(data => console.log(data));
    

📌 Example Request (GET) – Using cURL (Manual Encoding):

  curl -X GET "https://flix-api-b.onrender.com/recommend?query=John%20Wick%20but%20with%20a%20female%20lead&platform_only=false&user_country=US" \
  -H "X-API-KEY: your_api_key_here"
    

📌 Example Request (GET) – Using cURL (Auto-Encoding Query):

  curl -G "https://flix-api-b.onrender.com/recommend" \
  --data-urlencode "query=John Wick but with a female lead" \
  --data-urlencode "platform_only=false" \
  --data-urlencode "user_country=US" \
  -H "X-API-KEY: your_api_key_here"
    

📌 Example Response:

  {
    "recommendations": [
      {
        "title": "Killing Eve",
        "cast": ["Sandra Oh", "Jodie Comer", "Fiona Shaw"],
        "rating": 8.0,
        "runtime": "43 min",
        "release_date": "2018-04-08",
        "platforms": ["Netflix", "HBO Max"],
        "fullplot": "A security consultant hunts for a ruthless assassin...",
        "TV": false,
        "score": 0.95
      },
      {
        "title": "Ava",
        "cast": ["Jessica Chastain", "John Malkovich"],
        "rating": 5.8,
        "runtime": "96 min",
        "release_date": "2020-07-02",
        "platforms": ["Amazon Prime Video"],
        "fullplot": "A black ops assassin is forced to fight for her own survival...",
        "TV": false,
        "score": 0.92
      }
    ]
  }