Kaynaklar

Ürünler

Ürün detaylarına erişin ve ürünlerde arama yapın.

Plana Göre Yanıt Farkları

Başlangıç planı: id, name, code, category, prices ve groups alanlarını döner.
Profesyonel planı: Tüm alanları döner (images, attributes, slug, genre, game, market dahil).

Ürünleri Listele

GET/api/v1/items

Tüm ürünleri sayfa sayfa listeler. Her iki plan için kullanılabilir.

Query Parametreleri

Alan	Tip	Açıklama
`page`	integer	Sayfa numarası (varsayılan: 1)
`per_page`	integer	Sayfa başına ürün sayısı (varsayılan: 20, max: 100)
`search`	string	İsim veya koda göre filtrele
`category_id`	integer	Kategoriye göre filtrele
`game`	string	Oyun türüne göre filtrele (pokemon, onepiece)
`market`	string	Pazara göre filtrele
`genre`	string	Türe göre filtrele
`sort_by`	string	Sıralama alanı (varsayılan: name)
`sort_order`	string	Sıralama yönü: asc veya desc (varsayılan: asc)

Örnek İstek

cURL

curl -X GET "https://kartfiyat.com/api/v1/items?page=1&per_page=20&game=pokemon" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

JSON

{
  "success": true,
  "data": [
    {
      "id": 12345,
      "name": "Pikachu VMAX",
      "code": "SWSH045",
      "category": {
        "id": 101,
        "name": "Paldea Evolved"
      },
      "prices": [
        {
          "label": "Near Mint",
          "price": 450.00,
          "updated_at": "2026-02-03T10:30:00Z"
        }
      ],
      "groups": [
        {
          "id": 1,
          "name": "Ungraded"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 20,
    "total": 5420,
    "last_page": 271,
    "has_more": true
  }
}

Ürün Detayı

GET/api/v1/items/{id}

Belirli bir ürünün detaylarını döner.

Path Parametreleri

Alan	Tip	Açıklama
`id`	integer	Ürün ID'si

Örnek İstek

cURL

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

Örnek YanıtProfesyonel

JSON

{
  "success": true,
  "data": {
    "id": 12345,
    "name": "Pikachu VMAX",
    "code": "SWSH045",
    "slug": "pikachu-vmax-swsh045",
    "genre": "Pokemon",
    "game": "pokemon",
    "market": "TR",
    "category": {
      "id": 101,
      "name": "Paldea Evolved",
      "slug": "paldea-evolved"
    },
    "images": [
      {
        "id": 1,
        "url": "https://kartfiyat.com/storage/items/pikachu-vmax.jpg",
        "order": 1
      },
      {
        "id": 2,
        "url": "https://kartfiyat.com/storage/items/pikachu-vmax-back.jpg",
        "order": 2
      }
    ],
    "prices": [
      {
        "label": "Near Mint",
        "price": 450.00,
        "updated_at": "2026-02-03T10:30:00Z"
      },
      {
        "label": "Lightly Played",
        "price": 380.00,
        "updated_at": "2026-02-03T10:30:00Z"
      },
      {
        "label": "PSA 10",
        "price": 2500.00,
        "updated_at": "2026-02-03T10:30:00Z"
      }
    ],
    "groups": [
      {
        "id": 1,
        "name": "Ungraded",
        "slug": "ungraded"
      },
      {
        "id": 2,
        "name": "Graded",
        "slug": "graded"
      }
    ],
    "attributes": [
      {
        "name": "Rarity",
        "value": "Ultra Rare"
      },
      {
        "name": "Set Number",
        "value": "045/073"
      }
    ]
  }
}

Örnek YanıtBaşlangıç

Başlangıç planında temel ürün bilgileri ile birlikte gruplar döner:

JSON

{
  "success": true,
  "data": {
    "id": 12345,
    "name": "Pikachu VMAX",
    "code": "SWSH045",
    "category": {
      "id": 101,
      "name": "Paldea Evolved"
    },
    "prices": [
      {
        "label": "Near Mint",
        "price": 450.00,
        "updated_at": "2026-02-03T10:30:00Z"
      },
      {
        "label": "Lightly Played",
        "price": 380.00,
        "updated_at": "2026-02-03T10:30:00Z"
      },
      {
        "label": "PSA 10",
        "price": 2500.00,
        "updated_at": "2026-02-03T10:30:00Z"
      }
    ],
    "groups": [
      {
        "id": 1,
        "name": "Ungraded"
      },
      {
        "id": 2,
        "name": "Graded"
      }
    ]
  }
}

Ürün Arama

GET/api/v1/items/search

Ürünlerde arama yapar.

Query Parametreleri

Alan	Tip	Açıklama
`q`zorunlu	string	Arama sorgusu (min 2 karakter)
`category_id`	integer	Belirli bir kategoride ara
`game`	string	Oyun türüne göre filtrele
`market`	string	Pazara göre filtrele
`per_page`	integer	Sayfa başına sonuç (varsayılan: 50, max: 100)
`page`	integer	Sayfa numarası

Örnek İstek

cURL

curl -X GET "https://kartfiyat.com/api/v1/items/search?q=charizard&game=pokemon" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

JSON

{
  "success": true,
  "data": [
    {
      "id": 54321,
      "name": "Charizard ex",
      "code": "SV03-125",
      "slug": "charizard-ex-sv03-125",
      "category": {
        "id": 102,
        "name": "Obsidian Flames",
        "slug": "obsidian-flames"
      },
      "images": [
        {
          "id": 1,
          "url": "https://kartfiyat.com/storage/items/charizard-ex.jpg",
          "order": 1
        }
      ],
      "prices": [
        {
          "label": "Near Mint",
          "price": 1250.00,
          "updated_at": "2026-02-03T10:30:00Z"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 45,
    "last_page": 1,
    "has_more": false
  }
}

Ürün Nesnesi

Bir ürün nesnesi aşağıdaki alanları içerir. Profesyonel etiketi olan alanlar yalnızca Profesyonel planda döner.

Alan	Tip	Plan	Açıklama
`id`	`integer`	Tümü	Benzersiz ürün ID'si
`name`	`string`	Tümü	Ürün adı
`code`	`string\|null`	Tümü	Ürün kodu (varsa)
`category`	`object`	Tümü	Ürünün ait olduğu kategori (Başlangıç: sadece id ve name)
`prices`	`array`	Tümü	Duruma göre fiyat listesi
`slug`	`string`	Profesyonel	URL-dostu benzersiz tanımlayıcı
`genre`	`string\|null`	Profesyonel	Ürün türü
`game`	`string`	Profesyonel	Oyun (pokemon, onepiece)
`market`	`string`	Profesyonel	Pazar (pricecharting, cardmarket)
`images`	`array`	Profesyonel	Ürün görselleri listesi
`groups`	`array`	Tümü	Ürün grupları (Graded, Ungraded vb.)
`attributes`	`array`	Profesyonel	Ek ürün özellikleri

Fiyat Etiketleri

Fiyatlar farklı durumlar için ayrı ayrı sunulur:

Etiket	Açıklama
`Near Mint`	Neredeyse mükemmel durumda
`Lightly Played`	Hafif kullanılmış
`Moderately Played`	Orta düzeyde kullanılmış
`Heavily Played`	Yoğun kullanılmış
`PSA 10`	PSA 10 derecelendirmeli
`CGC 10`	CGC 10 derecelendirmeli