Giphy Search Discovery API

Tag autocompletion, related search terms, and trending search queries.

Documentation

Specifications

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-gif-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-clip-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-user-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-channel-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-category-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-images-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-analytics-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-meta-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-schema/giphy-pagination-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-structure/giphy-gif-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-structure/giphy-clip-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-structure/giphy-images-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/json-structure/giphy-channel-structure.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-search-gifs-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-get-trending-gifs-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-translate-gif-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-get-random-gif-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-get-gif-by-id-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-list-gif-categories-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-autocomplete-search-tags-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-get-related-search-terms-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-get-trending-searches-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-search-stickers-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-list-emoji-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-search-clips-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-upload-gif-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/examples/giphy-register-search-action-example.json
🔗
SDKs
https://github.com/Giphy/giphy-ios-sdk
🔗
SDKs
https://github.com/Giphy/giphy-android-sdk
🔗
SDKs
https://github.com/Giphy/giphy-react-native-sdk
🔗
SDKs
https://github.com/Giphy/giphy-flutter-sdk
🔗
SDKs
https://github.com/Giphy/giphy-js
🔗
SDKs
https://github.com/Giphy/giphy-python-client
🔗
SDKs
https://github.com/Giphy/giphy-ruby-client
🔗
SDKs
https://github.com/Giphy/giphy-php-client
🔗
Pricing
https://raw.githubusercontent.com/api-evangelist/giphy/refs/heads/main/plans/giphy-plans-pricing.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/giphy-search-discovery-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

giphy-search-discovery-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: GIPHY Analytics Search Discovery API
  description: 'The GIPHY API provides programmatic access to the world''s largest library of

    GIFs, stickers, animated emoji and Clips (GIFs with sound). Search, trending,

    translate, random, and category endpoints all return rich media objects with

    multiple image renditions optimized for any surface.


    Authentication is via API key. New developers receive a rate-limited Beta key;

    a Production key is granted after application review.

    '
  version: '1.0'
  contact:
    name: GIPHY Developers
    url: https://developers.giphy.com/
    email: support@giphy.com
  termsOfService: https://developers.giphy.com/terms/
  license:
    name: GIPHY API Terms of Service
    url: https://developers.giphy.com/terms/
servers:
- url: https://api.giphy.com
  description: Production API
- url: https://upload.giphy.com
  description: Upload API
security:
- ApiKeyAuth: []
tags:
- name: Search Discovery
  description: Tag autocompletion, related search terms, and trending search queries.
paths:
  /v1/gifs/search/tags:
    get:
      tags:
      - Search Discovery
      operationId: autocompleteSearchTags
      summary: Autocomplete Search Tags
      description: Return tag suggestions for a partial search term.
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - name: q
        in: query
        required: true
        description: Partial search term.
        schema:
          type: string
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          description: Tag autocomplete results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        analytics_response_payload:
                          type: string
  /v1/tags/related/{term}:
    get:
      tags:
      - Search Discovery
      operationId: getRelatedSearchTerms
      summary: Get Related Search Terms
      description: Return related search terms for a given query.
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - name: term
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Related search terms.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        analytics_response_payload:
                          type: string
  /v1/trending/searches:
    get:
      tags:
      - Search Discovery
      operationId: getTrendingSearches
      summary: Get Trending Search Terms
      description: Return the most popular search terms across GIPHY.
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Trending search terms.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: string
                  meta:
                    $ref: '#/components/schemas/Meta'
components:
  parameters:
    Offset:
      name: offset
      in: query
      required: false
      description: Position in the result set for pagination.
      schema:
        type: integer
        default: 0
    ApiKey:
      name: api_key
      in: query
      required: true
      description: GIPHY API key (Beta or Production).
      schema:
        type: string
    Limit:
      name: limit
      in: query
      required: false
      description: Maximum number of items to return per page.
      schema:
        type: integer
        default: 25
        maximum: 50
  schemas:
    Meta:
      type: object
      properties:
        msg:
          type: string
        status:
          type: integer
        response_id:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: api_key
      description: API key issued via the GIPHY developer dashboard.