Kom i gang
Slik begynner du å bruke TCG Price Lookup API på under 5 minutter.
1. Hent en API-nøkkel
Registrer deg på tcgpricelookup.com og hent en gratis API-nøkkel fra dashbordet. Gratis plan inkluderer 200 forespørsler per dag — ingen kredittkort kreves.
Etter innlogging, naviger til Dashboard → API-nøkler. Nøkkelen har følgende format:
tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Hold denne nøkkelen hemmelig. Ikke commit den til versjonskontroll eller eksponer den i klientside-kode.
2. Installer en SDK
Velg ditt foretrukne språk og installer den offisielle SDK-en:
# JavaScript / TypeScript
npm install tcglookup
# Python
pip install tcglookup
# Go
go get github.com/TCG-Price-Lookup/tcglookup-go
# Rust
cargo add tcglookup
# PHP
composer require tcg-price-lookup/tcglookup
Alle SDKer håndterer automatisk autentisering, forespørsels-serialisering, feilanalyse og ratebegrensningsheadere.
3. Send din første forespørsel
Her er minimale eksempler for hvert støttet språk:
// JavaScript / TypeScript
import { TCGLookup } from 'tcglookup';
const tcg = new TCGLookup({ apiKey: 'your-api-key' });
const results = await tcg.search('charizard', { game: 'pokemon', limit: 5 });
console.log(results.data);
// → Array med kortobjekter inkludert live markedspriser
# Python
from tcglookup import TCGLookup
tcg = TCGLookup(api_key='your-api-key')
results = tcg.search('charizard', game='pokemon', limit=5)
print(results.data)
// Go
client := tcglookup.NewClient("your-api-key")
results, _ := client.Search("charizard", &tcglookup.SearchParams{Game: "pokemon"})
4. Inspisér responsen
En vellykket respons har følgende struktur:
{
"data": [
{
"id": "pokemon-base1-4",
"name": "Charizard",
"game": "pokemon",
"set": { "name": "Base Set", "code": "base1" },
"rarity": "Rare Holo",
"prices": {
"nearMint": {
"market": 450.00,
"tcgplayer": 445.00,
"ebay": 455.00
},
"lightlyPlayed": {
"market": 380.00
}
}
}
],
"total": 12,
"limit": 5,
"offset": 0
}
5. Neste steg
- Autentisering — Slik bruker du API-nøkkelen trygt
- API-endepunkter — Alle tilgjengelige endepunkter
- Feilhåndtering — Slik håndterer du feil
- SDKer og biblioteker — Detaljert SDK-dokumentasjon