# Openverse — Zapi reference

> Searches an index of openly-licensed media and returns image metadata with attribution.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/search-tools/openverse
- Endpoint catalog: https://zpi.web.id/category/search-tools
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Openverse

**Category:** search-tools · **Slug:** `openverse`
**Detail page:** https://zpi.web.id/api/search-tools/openverse

Searches an index of openly-licensed media and returns image metadata with attribution.

**Tags:** search, images, creative-commons

### Search

Returns openly-licensed images with URLs, license info, and attribution data for a query.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/search-tools:openverse/search`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Search keyword |
| `count` | number | query | no | Results per page 1-30 (default 12) |
| `page` | number | query | no | Result page (default 1, max 50) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/search-tools:openverse/search?query=cat&count=12&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/search-tools:openverse/search?query=cat&count=12&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/search-tools:openverse/search?query=cat&count=12&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 5,
  "items": [
    {
      "id": "1c5442f6-6bb6-4ab7-b603-f598e7579dd2",
      "url": "https://www.flickr.com/photos/32426194@N00/3481540500",
      "image": "https://live.staticflickr.com/3313/3481540500_c846c62863_b.jpg",
      "title": "Cat Fish 2",
      "source": "openverse.org",
      "creator": "admiller",
      "license": "by 2.0",
      "provider": "flickr",
      "thumbnail": "https://api.openverse.org/v1/images/1c5442f6-6bb6-4ab7-b603-f598e7579dd2/thumb/",
      "licenseUrl": "https://creativecommons.org/licenses/by/2.0/"
    },
    {
      "id": "de42d499-d660-47b4-b203-28d5589c31d2",
      "url": "https://www.flickr.com/photos/29468339@N02/5840168826",
      "image": "https://live.staticflickr.com/2706/5840168826_486f364c6c_b.jpg",
      "title": "Cat bliss",
      "source": "openverse.org",
      "creator": "@Doug88888",
      "license": "by-nc-sa 2.0",
      "provider": "flickr",
      "thumbnail": "https://api.openverse.org/v1/images/de42d499-d660-47b4-b203-28d5589c31d2/thumb/",
      "licenseUrl": "https://creativecommons.org/licenses/by-nc-sa/2.0/"
    },
    {
      "id": "b9bbd2be-a68e-4d2c-ad85-f43000cb8d55",
      "url": "https://www.flickr.com/photos/93665474@N00/3717404325",
      "image": "https://live.staticflickr.com/3436/3717404325_db41d8d687_b.jpg",
      "title": "cat",
      "source": "openverse.org",
      "creator": "Alex Balan",
      "license": "by-nc-sa 2.0",
      "provider": "flickr",
      "thumbnail": "https://api.openverse.org/v1/images/b9bbd2be-a68e-4d2c-ad85-f43000cb8d55/thumb/",
      "licenseUrl": "https://creativecommons.org/licenses/by-nc-sa/2.0/"
    },
    {
      "id": "3d32b0c5-58b3-4e38-b034-cd6c8d674d73",
      "url": "https://www.flickr.com/photos/32695450@N05/11748899763",
      "image": "https://live.staticflickr.com/7300/11748899763_2dd16da8b4_b.jpg",
      "title": "cat in the sun",
      "source": "openverse.org",
      "creator": "fidber",
      "license": "by 2.0",
      "provider": "flickr",
      "thumbnail": "https://api.openverse.org/v1/images/3d32b0c5-58b3-4e38-b034-cd6c8d674d73/thumb/",
      "licenseUrl": "https://creativecommons.org/licenses/by/2.0/"
    },
    {
      "id": "aafaf91c-4d64-4f2e-b8ec-d7e77131b888",
      "url": "https://www.flickr.com/photos/57443751@N07/6494613787",
      "image": "https://live.staticflickr.com/7004/6494613787_9a3031fa7d_b.jpg",
      "title": "Cat on the sofa",
      "source": "openverse.org",
      "creator": "sushiraider",
      "license": "by-nc-sa 2.0",
      "provider": "flickr",
      "thumbnail": "https://api.openverse.org/v1/images/aafaf91c-4d64-4f2e-b8ec-d7e77131b888/thumb/",
      "licenseUrl": "https://creativecommons.org/licenses/by-nc-sa/2.0/"
    }
  ],
  "total": 240,
  "hasMore": true,
  "nextPage": 2
}
```

---


_Generated: 2026-08-02T14:24:28.825Z_