Kaynaklar

Kategoriler

Tüm ürün kategorilerini listeleyin ve kategori detaylarına erişin.

Profesyonel Plan Gerektirir

Kategori listeleme, detay ve ağaç yapısı endpoint'leri yalnızca Profesyonelplanda kullanılabilir. Başlangıç planı ile bu endpoint'lere istek yapıldığında 403 PLAN_UPGRADE_REQUIRED hatası döner. Başlangıç planında kategori bilgisi yalnızca ürün yanıtlarındaki category alanı üzerinden erişilebilir.

Kategorileri Listele

GET/api/v1/categories

Tüm kategorileri listeler.

Query Parametreleri

Alan	Tip	Açıklama
`game`	string	Oyun türüne göre filtrele (pokemon, onepiece)
`market`	string	Pazara göre filtrele (pricecharting, cardmarket)
`parent_id`	integer	Belirli bir üst kategorinin alt kategorilerini getir

Örnek İstek

cURL

curl -X GET "https://kartfiyat.com/api/v1/categories?game=pokemon" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

JSON

{
  "success": true,
  "data": [
    {
      "id": 1,
      "parent_id": null,
      "name": "Pokemon TCG",
      "slug": "pokemon-tcg",
      "image": "https://kartfiyat.com/storage/categories/pokemon.jpg",
      "release_date": "1996-10-20",
      "game": "pokemon",
      "market": "TR",
      "parent": null,
      "children": []
    }
  ]
}

Kategori Ağacı

GET/api/v1/categories/tree

Kategorileri hiyerarşik (ağaç) yapısında döner.

Örnek Yanıt

JSON

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Pokemon TCG",
      "slug": "pokemon-tcg",
      "children": [
        {
          "id": 10,
          "name": "Scarlet & Violet",
          "slug": "scarlet-violet",
          "children": [
            {
              "id": 101,
              "name": "Paldea Evolved",
              "slug": "paldea-evolved"
            }
          ]
        }
      ]
    }
  ]
}

Kategori Detayı

GET/api/v1/categories/{id}

Belirli bir kategorinin detaylarını döner.

Path Parametreleri

Alan	Tip	Açıklama
`id`	integer	Kategori ID'si

Örnek İstek

cURL

curl -X GET "https://kartfiyat.com/api/v1/categories/1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

JSON

{
  "success": true,
  "data": {
    "id": 1,
    "parent_id": null,
    "name": "Pokemon TCG",
    "slug": "pokemon-tcg",
    "image": "https://kartfiyat.com/storage/categories/pokemon.jpg",
    "release_date": "1996-10-20",
    "game": "pokemon",
    "market": "TR",
    "parent": null,
    "children": [
      {
        "id": 10,
        "name": "Scarlet & Violet",
        "slug": "scarlet-violet"
      }
    ]
  }
}

Kategori Ürünleri

GET/api/v1/categories/{id}/items

Belirli bir kategorideki tüm ürünleri listeler.

Query Parametreleri

Alan	Tip	Açıklama
`search`	string	Ürün adında arama
`genre`	string	Türe göre filtrele
`sort_by`	string	Sıralama alanı (name, created_at, updated_at) (varsayılan: name)
`sort_order`	string	Sıralama yönü (asc, desc) (varsayılan: asc)
`per_page`	integer	Sayfa başına ürün (max: 100) (varsayılan: 50)
`page`	integer	Sayfa numarası (varsayılan: 1)

Örnek Yanıt

JSON

{
  "success": true,
  "data": [
    {
      "id": 12345,
      "name": "Pikachu VMAX",
      "code": "SWSH045",
      "slug": "pikachu-vmax-swsh045",
      "images": [
        {
          "id": 1,
          "url": "https://kartfiyat.com/storage/items/pikachu-vmax.jpg",
          "order": 1
        }
      ],
      "prices": [
        {
          "label": "Near Mint",
          "price": 450.00,
          "updated_at": "2026-02-03T10:30:00Z"
        }
      ],
      "groups": [
        {
          "id": 1,
          "name": "Ungraded",
          "slug": "ungraded"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 156,
    "last_page": 4,
    "has_more": true
  },
  "category": {
    "id": 101,
    "name": "Paldea Evolved",
    "slug": "paldea-evolved"
  }
}