API publique pour les développeurs
Une API JSON gratuite en lecture seule : prix des objets CS2, estimation d’inventaire Steam, équipes et joueurs pros. Elle fonctionne sans clé ni inscription, CORS ouvert, prix en dollars US actualisés environ toutes les heures. Une clé gratuite, créée depuis votre profil, relève les limites.
Endpoints
Le tableau est généré à partir du document OpenAPI ; les descriptions sont en anglais. Les paramètres marqués * sont obligatoires.
| Endpoint | Renvoie | Paramètres |
|---|---|---|
GET /api/v1/inventory | Appraise a public CS2 Steam inventory | steam*lang |
GET /api/v1/inventories | Stored appraisals of up to 50 Steam inventories in one call (200 with an API key) | steam*lang |
GET /api/v1/price | Find CS2 items by name and get their current prices | q*lang |
GET /api/v1/price/history | Daily price history of one CS2 item | q*dayslang |
GET /api/v1/teams | Top CS2 teams by the official Valve ranking | region |
GET /api/v1/teams/{slug} | Team profile: roster, trophies, current events, recent matches, map stats and rank history | slug* |
GET /api/v1/players | Players of the ranked teams, optionally only those with a public Steam profile | steamlimit |
GET /api/v1/players/{slug} | Player of a ranked team | slug* |
Limites
Sans clé, les limites sont comptées par adresse IP ; la section suivante les compare à celles d’une clé personnelle. Les assistants IA connus, reconnus à leur User-Agent, ont leur propre palier :
- Requêtes par minute pour les assistants IA connus sur /api/v1
- 600
- Estimations d’inventaire par heure pour les assistants IA
- 600
- Consultations par minute de profils jamais estimés, budget commun à tous les assistants IA
- 8
Au-delà de la limite, l’API répond 429, et 503 pendant le calcul d’une nouvelle estimation ; les deux réponses portent Retry-After en secondes. Attendez ce délai et réessayez une fois.
Des limites plus hautes avec une clé d’API
Tous les endpoints fonctionnent sans clé. Avec une clé personnelle gratuite, les limites sont comptées par clé et non par adresse IP, elles sont plus élevées, et /api/v1/inventory attend jusqu’à 25 s une estimation fraîche au lieu de répondre 503.
| Limite | Sans clé | Avec clé |
|---|---|---|
| Requêtes par minute | 120 | 600 |
| Estimations d’inventaire par heure | 60 | 300 |
| Profils jamais estimés, par minute | dans la limite horaire | 30 |
| Profils par appel à /api/ | 50 | 200 |
Obtenir une clé
- Connectez-vous via Steam et ouvrez la section « Clés d’API » de votre profil. Aller au profil
- Les clés sont réservées aux comptes créés depuis au moins un jour. Vous pouvez garder jusqu’à 3 clés actives, chacune avec un nom qui indique son usage.
- Une clé ne s’affiche qu’une fois, à sa création : nous n’en gardons que l’empreinte (hash). Une clé perdue ou divulguée se révoque en un clic et se remplace par une nouvelle.
Transmettre la clé
Passez la clé dans l’en-tête Authorization avec le schéma Bearer ou dans l’en-tête X-Api-Key. Les clés ne sont lues que sur /api/v1 ; ne les mettez ni dans du code exécuté par le navigateur ni dans des dépôts publics.
curl -H "Authorization: Bearer $CS2C_KEY" \
"https://cs2collections.net/api/v1/price?q=AK-47%20%7C%20Redline"
curl -H "X-Api-Key: $CS2C_KEY" \
"https://cs2collections.net/api/v1/inventory?steam=76561197960287930" En-têtes de réponse et erreurs
- X-RateLimit-Limit
- requêtes par minute autorisées pour cette clé
- X-RateLimit-Remaining
- requêtes restantes dans la fenêtre en cours
- X-RateLimit-Reset
- secondes avant la remise à zéro de la fenêtre
Une clé mal saisie, inconnue ou révoquée n’est jamais ignorée : la requête reçoit 401 avec WWW-Authenticate au lieu de retomber sur les limites anonymes. La clé d’un compte banni reçoit 403. Au-delà de la limite, la réponse est 429 avec Retry-After.
Spécification et fichiers lisibles par machine
/api/openapi.jsonspécification OpenAPI 3.1 : paramètres, schémas de réponse et erreurs/.well-known/openapi.jsonla même spécification à l’adresse well-known/llms.txtprésentation du site avec modèles d’URL et recettes d’API pour les assistants IA/llms-full.txttous les guides texte en anglais dans un seul fichier Markdown/llms-catalog.txttop 500 des skins par valeur de marché listée, en JSON Lines, mis à jour toutes les heures/.well-known/ai-catalog.jsonmanifeste des capacités pour les agents IA- Méthodologie d’où viennent les prix et comment ils sont calculés
Licence
Les guides, textes éditoriaux et données dérivées propres au site (estimations du drop pool, RTP des caisses, indices, médianes journalières, tables de patterns, la compilation llms-catalog.txt) sont sous licence CC BY 4.0 : citez CS2Collections.net avec un lien vers la page source.
Les données des équipes et des joueurs (/api/v1/teams, /api/v1/players) proviennent de Liquipedia et sont sous licence CC BY-SA 4.0 : citez CS2Collections.net avec un lien et partagez les adaptations sous la même licence.
Le catalogue d’objets (noms, images, raretés et collections tirés des fichiers du jeu via le jeu de données CSGO-API) et les prix des marchés sont des données tierces. Ce site ne déclare aucune licence pour elles ; les conditions des sources d’origine s’appliquent.
Comment citer
Citez une page ainsi : « CS2Collections.net — titre de la page, URL, date de mise à jour », avec l’URL canonique et la date affichée par la page, sinon la date de consultation. Donnez les prix avec leur devise et leur heure : ils changent.
CS2Collections.net — AK-47 | Redline, https://cs2collections.net/fr/items/ak-47-redline, 2026-09-27