---
title: "Search stock photos"
method: GET
path: "/images/stock"
tags: ["Images"]
---

# Search stock photos

`GET /images/stock`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/images/stock`
- Auth: API key in header `Authorization`

Searches free Pexels stock photography by keyword and returns ready-to-use, resolvable image URLs. No credits are charged (`credits_used` is always 0).

## Query parameters

- `query` string, required
- `count` integer
- `orientation` 'landscape' | 'portrait' | 'square'
- `color` 'red' | 'orange' | 'yellow' | 'green' | 'turquoise' | 'blue' | 'violet' | 'pink' | 'brown' | 'black' | 'gray' | 'white'
- `size` 'large' | 'medium' | 'small'

## Response `200`

Matching stock photos

- object
  - `object` 'stock_photo_search_result'
  - `query` string
  - `total` integer: Total number of matching photos available upstream.
  - `credits_used` 0
  - `photos` object[]
    - `id` integer
    - `url` string: Link to the photo's page on Pexels.
    - `photographer` string
    - `photographer_url` string
    - `alt` string, nullable
    - `width` integer
    - `height` integer
    - `avg_color` string
    - `src` object
      - `original` string
      - `large` string
      - `medium` string
      - `small` string

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)