Sorgular

Kategoriler ve ürünler için örnek GraphQL sorguları. Tümü tek uç noktaya POST ile gönderilir.

POST https://kartfiyat.com/api/v3/graphql

Profesyonel plan ve üzeri

Pazar fiyatları (kartfiyat, pricecharting, tcgmarket, cardmarket) ve kart veri alanları (rarity, illustrator, hp, types, dexIds, stage, evolveFrom, suffix, level) yalnızca Profesyonel plan ve üzerinde döner.

Kategorileri Listele

query {
  categories(game: "pokemon") {
    nodes {
      id
      name
      slug
      image
      children { id name }
    }
    pageInfo { hasNextPage endCursor }
  }
}

Kategori Detayı

query {
  category(id: 10) {
    id
    name
    slug
    parent { id name }
    children { id name slug }
  }
}

Kategorideki Ürünler

query {
  category(id: 10) {
    items(first: 20, search: "pikachu") {
      nodes {
        id
        name
        code
        prices { label price updatedAt }
      }
      pageInfo { hasNextPage endCursor }
    }
  }
}

Ürün Arama ve Listeleme

query {
  items(
    game: "pokemon"
    search: "charizard"
    first: 10
    sortBy: "name"
    sortOrder: "asc"
  ) {
    nodes {
      id
      name
      code
      category { id name slug }
      prices { label price }
    }
    pageInfo { hasNextPage endCursor }
  }
}

query {
  items(search: "charizard", first: 3) {
    nodes { id name code }
  }
}

Ürün Detayı

Ürünün temel bilgileri, tüm pazar fiyatları (market ile ayrışır) ve kart veri alanları.

query {
  item(id: 12345) {
    id
    name
    code
    slug
    genre
    game
    category { id name slug }
    images { url order }
    prices { market label price currency updatedAt }
    groups { id name slug }
    attributes { name value }

    # Kart veri alanları (Profesyonel+)
    rarity
    illustrator
    hp
    types
    dexIds
    stage
    evolveFrom
    suffix
    level
  }
}

Pazar Fiyatları

Bir ürünün tüm pazarlardaki fiyatları prices alanından gelir. Fiyatın hangi pazara ait olduğu market alanıyla belli olur: kartfiyat, pricecharting, tcgmarket, cardmarket. Yalnızca belirli bir pazarın fiyatını almak isterseniz sorguda filtreleyebilirsiniz:

query {
  item(id: 12345) {
    name
    prices(markets: [TCGMARKET, CARDMARKET]) {
      market
      label
      price
      currency
    }
  }
}

Tüm Verileri İsteme

İsteyebileceğiniz tüm alanları içeren örnek. İhtiyacınız olmayan alanları çıkarabilirsiniz; ayrıntılı liste için Şema sayfasındaki "İstenebilecek Tüm Veriler" bölümüne bakın.

query {
  item(id: 12345) {
    id
    name
    code
    slug
    genre
    game
    category { id name slug parent { id name } }
    images { url order }
    groups { id name slug }
    attributes { name value }
    prices { market label price currency updatedAt }
    rarity
    illustrator
    hp
    types
    dexIds
    stage
    evolveFrom
    suffix
    level
  }
}

Önemli Notlar

Planına bağlı alanlar (örn. images, attributes, genre) yalnızca uygun planda döner.
Sayfalama first/after imleçleri ile yapılır (cursor-based).
Bir alanı istemezsen sorguya ekleme; yanıtta yalnızca istediğin alanlar döner.

Sayfalama ve fiyat etiketleri hakkında ayrıntı için Şema ve Rate Limiting sayfalarına bakın.