REST
Wyszukaj przedmioty
Wyszukaj przedmioty po nazwie na marketplace'ach, zwracając lekką listę dopasowań.
Endpoint
Wyszukuje przedmioty po nazwie i zwraca lekką listę dopasowań. Przydatne do autouzupełniania i do odkrywania dokładnej nazwy rynkowej, którą należy przekazać do Pobierz przedmiot.
GET /v2/items/search
Parametry zapytania
game
string
Kod gry (np.
CS2, Dota2, Rust, TF2).query
string
Szukany ciąg dopasowywany do nazw przedmiotów.
marketplace
string
Opcjonalny filtr marketplace'u. Pomiń, aby wyszukiwać na wszystkich marketplace'ach.
limit
number
Maksymalna liczba zwracanych wyników. Domyślnie
100.Uwierzytelnianie
Zobacz Przegląd REST po bazowy URL, uwierzytelnianie i format błędów.
Pola odpowiedzi
Odpowiedź to tablica obiektów podsumowujących przedmioty.
| Pole | Typ | Opis |
|---|---|---|
name | string | Rynkowa nazwa przedmiotu |
marketplace | string | Marketplace, na którym przedmiot jest wystawiony |
game | string | Gra, do której należy przedmiot |
priceUSD | number|null | Najniższa cena oferty w USD |
offerCount | number | Liczba otwartych ofert |
thumbnail | string|null | URL do miniatury przedmiotu |
updatedAt | number | Unix timestamp ostatniej aktualizacji |
Przykład odpowiedzi
response.json
[
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"offerCount": 128,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
},
{
"name": "AK-47 | Redline (Minimal Wear)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 78.20,
"offerCount": 42,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
}
]