# Search available items by name(s)

`GET /v2/search-items-by-name`

Usually used in combination with [/v1/prices](https://api.waxpeer.com/docs/#/Buy%20items/get_prices) as expand items group by name.

Rate limit shared with search by name endpoints and currently is 20 per minute for regular users (No limits for partners)

Maximum number of listings per name 50 (in ascending order of price)

A hold listing is created while the item is still under a Steam trade lock. You can buy it now, and it is delivered after the lock expires. Hold listings are omitted unless you pass include_hold=1 or true. Each hold listing then includes unlock_at (when the lock ends; delivery starts after that) and send_until (delivery deadline; if the item is not sent by then the trade fails and you are refunded in full). Both are RFC 3339 UTC. Regular listings omit both fields. A listing is trade-locked when unlock_at is present. Applies to every search mode.

Prices are integers. `1000` = `1 USD`.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `api` | query | string | required | Your [WAXPEER API](https://waxpeer.com/profile/user) |
| `game` | query | enum | optional | Which game would you like to edit items from  For csgo dopplers items 'phase' parameter available in response. Possible values: 'Emerald', 'Ruby', 'Sapphire', 'Black Pearl', 'Phase 1', 'Phase 2', 'Phase 3', 'Phase 4' |
| `name` | query | string | required | Multiple queries of name, so you can pass it like this name=AK-47 \| Aquamarine Revenge (Factory New)&name=AK-47 \| Aquamarine Revenge (Factory New). Max 50 at once |
| `minified` | query | enum | optional | Will return additional data about items if set to 0 |
| `delivery_details` | query | enum | optional | Will return delivery information if set to 1 |
| `ignore_phase` | query | enum | optional | Will ignore phase filtering if set to 1 |
| `include_hold` | query | string | optional | 1 / true: also return trade-locked listings. Without this parameter the response is unchanged. Applies to every search mode. |

## Example (curl)

```bash
curl -X GET 'https://api.waxpeer.com/v2/search-items-by-name?api=%7B%7BAPI_KEY%7D%7D&game=csgo&name=AK-47+%7C+Redline+%28Field-Tested%29&minified=1&delivery_details=0&ignore_phase=0'
```

## Example response

```json
{
  "success": true,
  "items": {
    "Glock-18 | Gamma Doppler (Field-Tested)": [
      {
        "name": "Glock-18 | Gamma Doppler (Field-Tested)",
        "price": 2050000,
        "image": "https://steamcommunity-a.akamaihd.net/economy/image/class/730/4887510722",
        "item_id": "27165625734",
        "phase": "Phase 1",
        "float": 0.2447746992111206,
        "steam_price": 1709860,
        "sticker_names": [
          "Sticker | FaZe Clan | Boston 2018"
        ],
        "stickers": [
          {
            "name": "Sticker | FaZe Clan | Boston 2018",
            "image": "https://steamcdn-a.akamaihd.net/apps/730/icons/econ/stickers/boston2018/faze_clan.2e4d2a2e2e2a2e2a2e2a2e2a2e2a2e2a2e2a2a.png",
            "wear": 0,
            "slot": 1,
            "price": 1000
          }
        ],
        "unlock_at": "2026-08-04T12:00:00Z",
        "send_until": "2026-08-05T12:00:00Z"
      }
    ]
  }
}
```

## Responses

- `200` successful operation

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | optional |  |
| `items` | object | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested)` | array<object> | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).name` | string | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).price` | number | optional | Item price (1000 = 1$) |
| `items.Glock-18 | Gamma Doppler (Field-Tested).image` | string | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).item_id` | string | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).phase` | string | optional | Steam csgo item doppler phase. Available only on doppler items. Possible values: 'Emerald', 'Ruby', 'Sapphire', 'Black Pearl', 'Phase 1', 'Phase 2', 'Phase 3', 'Phase 4' |
| `items.Glock-18 | Gamma Doppler (Field-Tested).float` | number | optional | Item float For CS:GO game |
| `items.Glock-18 | Gamma Doppler (Field-Tested).steam_price` | number | optional | Steam item price (1000 = 1$) |
| `items.Glock-18 | Gamma Doppler (Field-Tested).sticker_names` | array<string> | optional | Sticker names |
| `items.Glock-18 | Gamma Doppler (Field-Tested).stickers` | array<object> | optional | Stickers |
| `items.Glock-18 | Gamma Doppler (Field-Tested).stickers.name` | string | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).stickers.image` | string | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).stickers.wear` | number | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).stickers.slot` | number | optional |  |
| `items.Glock-18 | Gamma Doppler (Field-Tested).stickers.price` | number | optional | Sticker price (1000 = 1$). If the sticker is not on sale, then the price will be 0 |
| `items.Glock-18 | Gamma Doppler (Field-Tested).unlock_at` | string | optional | When the Steam trade lock ends. Delivery starts after this. RFC 3339 UTC. Present only on a trade-locked listing returned with include_hold. Regular listings omit this field. |
| `items.Glock-18 | Gamma Doppler (Field-Tested).send_until` | string | optional | Delivery deadline. If the item is not delivered by then, the trade fails and you are refunded in full. RFC 3339 UTC. Present only on a trade-locked listing. Regular listings omit this field. |

- `429` Too many queries. The limit for search endpoints actions to regular users is 20 requests per 60 seconds

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | optional |  |
| `msg` | string | optional | Reason why request failed |
| `msBeforeNext` | number | optional | Milliseconds before next request |


## Notes for agents

- Auth is the query parameter `api`, not an Authorization header.
- See [/statuses.md](/statuses.md) for numeric trade status plus `escrow_status` / `release_date`.
- Prefer GET /v2/search-items-by-name over v1.
- Prefer GET /v2/get-items-list over v1 (cursor keyset pagination without the 5000 row cap). Pass next_cursor only while has_more is true.
- Prefer POST /v2/my-history over v1 (faster on long histories, ordered by trade id). On buy rows, price is the amount you paid.
- Trade-locked listings are omitted unless you pass include_hold=1. They then include unlock_at and send_until (RFC 3339 UTC).
- Buy a trade-locked listing only by exact item_id with allow_trade_locked (query 1 on GET /v1/buy-one-p2p, body true on POST /v1/buy). GET /v1/buy-one-p2p-name never sells hold items.
- CSV snapshot: GET /v1/prices/snapshot?format=csv (gzip). include_hold appends unlock_at,send_until. compact and whitemarket are JSON-only.
- Do not use GET /v1/ready-to-transfer-p2p; use the [trade websocket](/websocket.md).