ClipCafe

ClipCafe

This API allows users to search and download video clips from a diverse database, ideal for media platforms, educational content providers, and archival research.
                  {
    "took": 1,
    "timed_out": false,
    "_shards": { "total": 1, "successful": 1, "skipped": 0, "failed": 0 },
    "hits": {
        "total": { "value": 2, "relation": "eq" },
        "max_score": 21.314917,
        "hits": [
            {
                "_index": "videoclips",
                "_id": "369707",
                "_score": 21.314917,
                "_source": {
                    "clipID": 369707,
                    "title": "Oh my God",
                    "imdb": "tt0234215",
                    "slug": "oh-god-s142",
                    "transcript": "[Johnson blocks Neo's punch]\n\nNeo:\nHmm, upgrades. | Oh my God",
                    "episode": 0,
                    "season": 0,
                    "duration": 3,
                    "views": 75,
                    "likes": 0,
                    "resolution": "1920x800",
                    "date": "2022-11-25 09:25:10",
                    "subtitles": "{\"1\":{\"TimeStart\":1,\"TimeEnd\":2.042,\"Text\":\"Oh my God\"}}",
                    "actors": "Keanu Reeves,",
                    "characters": "Neo,",
                    "movie_title": "The Matrix Reloaded",
                    "movie_writer": "Lilly Wachowski, Lana Wachowski",
                    "movie_director": "Lana Wachowski, Lilly Wachowski",
                    "movie_summary": "Freedom fighters Neo, Trinity and Morpheus continue to lead the revolt against the Machine Army, unleashing their arsenal of extraordinary skills and weaponry against the systematic forces of repression and exploitation.",
                    "movie_actors": null,
                    "movie_year": 2003,
                    "movie_poster": "https://m.media-amazon.com/images/M/MV5BODE0MzZhZTgtYzkwYi00YmI5LThlZWYtOWRmNWE5ODk0NzMxXkEyXkFqcGdeQXVyNjU0OTQ0OTY@._V1_SX500.jpg",
                    "movie_postersize": "300x450",
                    "movie_imdbscore": "7.2",
                    "movie_metascore": "62",
                    "movie_slug": "the-matrix-reloaded-2003",
                    "download": "https://api.clip.cafe/?api_key=9951d6edc5744ee6c09b04132edefd00&key=210d559e4a489f83ace520e2ab383cc2a456c9410d7f164ba5b0681e1c287fb5&slug=oh-god-s142"
                }
            },
            {
                "_index": "videoclips",
                "_id": "325832",
                "_score": 16.717422,
                "_source": {
                    "clipID": 325832,
                    "title": "Have we met",
                    "imdb": "tt10838180",
                    "slug": "have-met-s1",
                    "transcript": "Neo:\nHi! \nTrinity:\n...Have we met? | Have we met",
                    "episode": 0,
                    "season": 0,
                    "duration": 3,
                    "views": 43,
                    "likes": 0,
                    "resolution": "1920x804",
                    "date": "2022-11-19 01:11:53",
                    "subtitles": "{\"1\":{\"TimeStart\":1,\"TimeEnd\":2.126,\"Text\":\"Have we met\"}}",
                    "actors": "Keanu Reeves,Carrie-Anne Moss,",
                    "characters": "Neo,Trinity,",
                    "movie_title": "The Matrix Resurrections",
                    "movie_writer": "Lana Wachowski, David Mitchell, Aleksandar Hemon",
                    "movie_director": "Lana Wachowski",
                    "movie_summary": "Return to a world of two realities: one, everyday life; the other, what lies behind it. To find out if his reality is a construct, to truly know himself, Mr. Anderson will have to choose to follow the white rabbit once more.",
                    "movie_actors": null,
                    "movie_year": 2021,
                    "movie_poster": "https://m.media-amazon.com/images/M/MV5BMGJkNDJlZWUtOGM1Ny00YjNkLThiM2QtY2ZjMzQxMTIxNWNmXkEyXkFqcGdeQXVyMDM2NDM2MQ@@._V1_SX500.jpg",
                    "movie_postersize": "500x741",
                    "movie_imdbscore": "5.7",
                    "movie_metascore": "63",
                    "movie_slug": "the-matrix-resurrections-2021",
                    "download": "https://api.clip.cafe/?api_key=9951d6edc5744ee6c09b04132edefd00&key=c7ec346bfeb041951cca8e77c37121e6bc3b32e00d83a760f9fc344a4746eab3&slug=have-met-s1"
                }
            }
        ]
    }
}
              

Response example. If you want to see more check the documentation.

This API allows users to search and download video clips from a diverse database, ideal for media platforms, educational content providers, and archival research. Every request must have parameter api-key for authentication. You can obtain it here (PRO subscription is required)

Authentication

API Key

  • Required: An API key is necessary for all requests.
  • Usage: Include api_key=YOUR_API_KEY in the query string.
  • Security: Treat your API key as sensitive information to prevent unauthorized access.
  • All integers can be used as ranges (e.g., 2005-2010 or 2005- or -2005).

Base URL

All API requests should be initiated to: https://api.clip.cafe/.

Download Video Clips

Method: GET
Purpose: Download a specific video clip.
Response: Binary stream of the video clip.

Query Parameters:

  • api_key (string) YOUR_API_KEY (mandatory).
  • slug (string) Unique identifier for the clip (mandatory).
  • key (string) Unique download key (mandatory).

Example Request:

GET /?api_key=YOUR_API_KEY&slug=clip-slug&key=DOWNLOAD_KEY HTTP/1.1
Host: api.clip.cafe

Error Codes

  • 200 OK: Successful request.
  • 400 Bad Request: Invalid request format or parameters.
  • 401 Unauthorized: Missing or invalid API key.
  • 403 Forbidden: Access denied.
  • 404 Not Found: Resource not found.
  • 429 Too Many Requests: Rate limit exceeded.
  • 500 Internal Server Error: Server error.