API Reference

Endpoint: Search GIFs

GET /api/gpi/search

Search the Nova GIF library for content matching your query.

Headers

Header	Type	Required	Description
apikey	string	Yes	Your application's API Key.

Query Parameters

Parameter	Type	Default	Description
q	string	-	Recommended. The search query text (e.g., "funny cat").
limit	integer	20	Number of results to return.
offset	integer	0	Number of results to skip (for pagination).
tags	string	-	Comma-separated list of tags to filter by (e.g., "cute,animal").
author	string	-	Filter by a specific author username.
type	string	-	Filter by media type (image/gif or video/mp4).
sort	string	upvotes	Sort order. Options: upvotes, created_at.

Response Format

Status: 200 OK

{
  "data": [
    {
      "id": "abc12345",
      "title": "Funny Cat Jump fails",
      "url": "https://media.nova-gifs.com/abc12345.gif",
      "thumbnail": "https://thumbs.nova-gifs.com/abc12345.jpg",
      "width": 800,
      "height": 600,
      "tags": ["cat", "funny", "fail", "jump"],
      "author": "CatLover99",
      "media_type": "image/gif"
    }
  ],
  "total": 1542,
  "limit": 20,
  "offset": 0
}

Error Codes

Status	Error Message	Description
401	Missing API Key	No API key was provided in headers.
401	Invalid API Key	The provided API key does not exist.
403	NovaGPI is not enabled...	Your API key is valid, but your app does not have GPI access.
403	API Key has expired	The key is no longer valid.
429	Usage limit exceeded	You have reached your request quota for the cycle.