Getting Started with the GIF Search API

Our GIF Search API allows you to easily integrate GIF discovery and search functionality into your own applications, websites, or services. This overview provides a basic understanding of how to get started.

Authentication

API access requires authentication. You will need to obtain an API key from your GIFMakes.com developer account. Include your API key in the request headers for all API calls.

Example Header:

Authorization: Bearer YOUR_API_KEY

Endpoint

The primary endpoint for searching GIFs is:

GET https://api.gifmakes.com/v1/search

Query Parameters

The search endpoint accepts various query parameters to filter and control search results.

• q (required): The search query string (e.g., "funny cat", "happy birthday").
• limit (optional): The maximum number of results to return (default: 25).
• offset (optional): The starting position for results (for pagination).
• lang (optional): Specify the language for search results.

Response

A successful search request will return a JSON response containing a list of matching GIFs and their metadata.

Example Success Response:

{
  "data": [
    {
      "id": "gif_id_1",
      "url": "https://gifmakes.com/gifs/gif_id_1.gif",
      "title": "Funny Cat GIF",
      "tags": ["funny", "cat", "animal"]
    },
    {
      "id": "gif_id_2",
      "url": "https://gifmakes.com/gifs/gif_id_2.gif",
      "title": "Happy Birthday Animation",
      "tags": ["happy birthday", "celebration"]
    }
  ],
  "pagination": {
    "total_count": 100,
    "offset": 0,
    "count": 2
  }
}

Error Handling

The API will return appropriate HTTP status codes and JSON error responses in case of failure (e.g., invalid API key, missing query, rate limits exceeded).

For detailed information, including all available endpoints, parameters, error codes, and rate limits, please refer to the full API Documentation.