Ü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).

GET /api/v1/items

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

Query Parametreleri

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

Örnek İstek

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

{
  "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
  }
}

GET /api/v1/items/{id}

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

Path Parametreleri

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

Örnek İstek

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

Örnek Yanıt Profesyonel

{
  "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ıt Başlangıç

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

{
  "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"
      }
    ]
  }
}

GET /api/v1/items/search

Ürünlerde arama yapar.

Query Parametreleri

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

Örnek İstek

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

Örnek Yanıt

{
  "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": [...],
      "prices": [...]
    }
  ],
  "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