# GET /v1/prices/search

Look up a specific skin (across marketplaces)

- Interactive docs: [https://cspriceapi.com/docs/api/prices-search](https://cspriceapi.com/docs/api/prices-search)
- OpenAPI YAML: [https://cspriceapi.com/openapi.yaml](https://cspriceapi.com/openapi.yaml)
- Data coverage: [https://cspriceapi.com/docs/data-coverage](https://cspriceapi.com/docs/data-coverage)

### GET /v1/prices/search

Look up a specific skin across all marketplaces (Basic)

Fetches the current price of a single `market_hash_name` from every
supported marketplace in one request.


If the query looks like a Doppler or Gamma Doppler skin (case-insensitive
substring `doppler`), the server strips any existing phase annotation
from the input and queries **all** phase variants in parallel:

- Regular Doppler: `(Ruby)`, `(Sapphire)`, `(Black Pearl)`,
  `(Phase 1)`..`(Phase 4)`
- Gamma Doppler: `(Emerald)`, `(Phase 1)`..`(Phase 4)`

The phase suffix is appended **after** the exterior, e.g.
`Glock-18 | Gamma Doppler (Factory New) (Phase 2)`.

The response schema therefore differs between the two cases:

- `is_doppler: false` → per marketplace either a single item object or `null`.
- `is_doppler: true`  → per marketplace an **array** of matched phase variants (possibly empty).

Clients should branch on the top-level `is_doppler` flag to select the
correct variant.

Most prices update about every 5 minutes, depending on the marketplace. Doppler phases included.

```bash
curl -s "https://api.cspriceapi.com/v1/prices/search" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

---

Full request/response schemas: import [openapi.yaml](https://cspriceapi.com/openapi.yaml) or use the Scalar UI on the HTML page.