---
title: "Search gear"
method: GET
path: "/gear"
tags: ["Gear"]
---

# Search gear

`GET /gear`

## Request

- Base URL: `https://outdoorithm.com/api/v1`
- URL: `https://outdoorithm.com/api/v1/gear`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Search the gear catalog by text, category, kit, necessity, tier, and price. Keyset pagination via `pagination.next_cursor`.

## Query parameters

- `q` string: Text search across name, manufacturer, keywords, and description.
- `category` string
- `kit` string
- `necessity` 'Essential' | 'Helpful' | 'Optional'
- `tier` string
- `min_price` number, nullable
- `max_price` number, nullable
- `limit` integer, nullable: Results per page (1–100, default 20).
- `cursor` string: Opaque pagination cursor from a previous response.

## Response `200`

A page of gear items.

- object
  - `data` GearListItem[], required
    - `object` 'gear_item', required
    - `id` string, required
    - `slug` string, nullable, required
    - `name` string, nullable, required
    - `manufacturer` string, nullable, required
    - `price` number, nullable, required
    - `currency` string, required
    - `picture` string, nullable, required
    - `necessity` string, nullable, required: Essential | Helpful | Optional
    - `recommendation_category` string, nullable, required
    - `kit_name` string, nullable, required
    - `category_name` string, nullable, required
    - `quick_verdict` string, nullable, required
    - `best_for` unknown[], required
      - unknown
    - `affiliate_links` object[], required
      - `type` string, required
      - `url` string, required
    - `url` string, required
  - `pagination` Pagination, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required

## Other responses

- `401`: Missing or invalid API key.
- `422`: Invalid query parameters.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/outdoorithm/apis/outdoorithm-api.md) · [All operations](https://skmtc.dev/outdoorithm/apis/outdoorithm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outdoorithm/apis/outdoorithm-api/revisions/2cdb8f1f7df2?raw)