---
updatedAt: 2026-02-12T18:29:58.000Z
agentTools:
  projectIndex: https://docs.embed.ly/llms.txt
---

# /1/display/webp

Convert an image to WebP format for better compression. 

For most use cases where response latency matters more than bandwidth savings, WebP is the sweet spot. AVIF makes sense mainly for static/cached assets where you encode once and serve many times.

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "iembedly",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://i.embed.ly"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "key",
        "in": "query",
        "x-default": ""
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/1/display/webp": {
      "get": {
        "summary": "Copy of Copy of /1/display",
        "description": "The Display endpoint is a simple proxy that allows you to embed insecure images into secure pages without warning and uses a fall back image for images not found.",
        "operationId": "display-1-1",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "description": "The URL of the image to proxy. The URL must be url-encoded to ensure that Embedly retrieves the correct link.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "key",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "Your Embedly API key."
          },
          {
            "name": "errorurl",
            "in": "query",
            "description": "The URL of the fall back image to use when url fails. The URL must be url-encoded to ensure that Embedly retrieves the correct link.",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "animate",
            "schema": {
              "type": "string",
              "default": "true"
            },
            "description": "Set to false to extract first frame from animated images."
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": ""
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request (missing/invalid parameters or upstream fetch error)",
            "content": {}
          },
          "401": {
            "description": "Unauthorized",
            "content": {}
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```