API Documentation

One endpoint. Search images, get a viewer URL.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer pixs99_your_api_key_here

Get your API key from the Dashboard.

POST /api/search

Search images and generate a shareable viewer page.

Request

curl -X POST https://pixs99.com/api/search \
  -H "Authorization: Bearer pixs99_your_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "tokyo skyline", "count": 10}'

Parameters

Field	Type	Required	Description
query	string	Yes	Search query
count	number	No	Number of images (1–20, default 8)

Response

{
  "viewer_url": "https://pixs99.com/v/abc123",
  "id": "abc123",
  "query": "tokyo skyline",
  "images": [
    {
      "url": "https://example.com/image.jpg",
      "title": "Tokyo Skyline at Night",
      "source": "https://example.com/page",
      "width": 1920,
      "height": 1080
    }
  ]
}

Rate Limits

Tier	Limit
API key	50 requests / day
Demo (no key)	10 requests / day per IP

When exceeded, the API returns 429 with Rate limit exceeded.

Errors

Status	Meaning
400	Missing or invalid query
401	Invalid or missing API key
429	Rate limit exceeded
500	Internal error