---
title: "GET /images/search"
method: GET
path: "/images/search"
tags: ["Images"]
---

# GET /images/search

`GET /images/search`

## Request

- Base URL: `https://alttext.ai/api/v1`
- URL: `https://alttext.ai/api/v1/images/search`
- Auth: API key in header `X-API-Key`

Search for images in your library. This request supports pagination using the `page` and `limit` parameters.

You can search by:
- **Alt text content**: Search for words or phrases in alt text (default behavior)
- **Asset ID**: Find a specific image by its unique identifier
- **URL**: Search by image URL substring

The search automatically detects the query type based on its format.

## Query parameters

- `q` string, required
- `page` integer
- `limit` integer

## Response `200`

Successful image alt text results returned.

- ImagesResponse
  - `images` Image[]
    - `asset_id` string: The unique ID of the image.
    - `url` string: The URL of the image. Will be `null` if the image was added via raw file upload.
    - `alt_text` string: The assigned alt text of the image.
    - `alt_texts` object: Alt text in requested languages, with language codes as keys.
    - `tags` unknown[]: Words or phrases that you want to associate with the image.
      - unknown
    - `metadata` object: Any custom information you want to store. This will be passed back on all API requests and webhooks.
    - `created_at` integer: Creation date of the image, in seconds since epoch.
    - `errors` object: Any errors associated with this image. Note - This will be an empty object for valid images.
    - `error_code` 'insufficient_credits' | 'invalid_params' | 'general': An identifier describing the type of error, if any.

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/alttext/apis/alttext-ai-api.md) · [All operations](https://skmtc.dev/alttext/apis/alttext-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alttext/apis/alttext-ai-api/revisions/6eb62e8e450c?raw)