The Cat API · Example Payload

The Cat Api Searchimages Example

AnimalsCatsImageMedia

The Cat Api Searchimages Example is an example object payload from The Cat API, with 2 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

requestresponse

Example Payload

{
  "request": {
    "method": "GET",
    "url": "https://api.thecatapi.com/v1/images/search?limit=2&breed_ids=beng&has_breeds=1",
    "headers": {
      "x-api-key": "YOUR_API_KEY"
    },
    "parameters": {
      "limit": 2,
      "breed_ids": "beng",
      "has_breeds": 1
    }
  },
  "response": [
    {
      "id": "bjl9it5k7",
      "url": "https://cdn2.thecatapi.com/images/bjl9it5k7.jpg",
      "width": 1080,
      "height": 1080,
      "breeds": [
        {
          "id": "beng",
          "name": "Bengal",
          "temperament": "Alert, Agile, Energetic, Demanding, Intelligent",
          "origin": "United States",
          "country_codes": "US",
          "description": "Bengals are a lot of fun to live with, but they're definitely not the cat for everyone, or for first-time cat owners.",
          "life_span": "12-15",
          "adaptability": 5,
          "affection_level": 5,
          "child_friendly": 4,
          "dog_friendly": 5,
          "energy_level": 5,
          "grooming": 1,
          "health_issues": 3,
          "intelligence": 5,
          "shedding_level": 3,
          "social_needs": 5,
          "stranger_friendly": 3,
          "vocalisation": 5,
          "indoor": 0,
          "lap": 0,
          "wikipedia_url": "https://en.wikipedia.org/wiki/Bengal_(cat)"
        }
      ]
    }
  ]
}

Work with this as data

Every example 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 examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
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 example

curl "https://apis.io/api/v1/examples/the-cat-api-searchImages-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

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

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

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