Satıcı ve alıcı ağacı
Etsy iki ağaç yayımlar. Satıcı ağacı (seller taxonomy) daha derindir ve ilanlar bu ağaçtaki düğümlere atanır. Alıcı ağacı (buyer taxonomy) vitrin için sadeleştirilmiştir. Etsy'nin örneğinde iplik ilanı alıcı ağacında yalnız "Craft Supplies & Tools" altında görünür, satıcı ağacında ise "Yarn & Fiber" ve "Yarn" alt düğümlerine kadar iner.
Entegrasyon için satıcı ağacını kullanın. Alıcı ağacı alıcıya yönelik uygulamalar içindir.
Düğüm alanları
| Alan | Anlamı |
|---|---|
| id | taxonomy_id olarak kullanılan düğüm kimliği |
| name | Düğüm adı (İngilizce) |
| level | Derinlik; kökler 0 |
| parent_id | Üst düğüm |
| children | Alt düğümler |
| full_path_taxonomy_ids | Bu düğüm ve köke kadar üst düğümler |
Ağaç büyük bir yanıttır. Her istekte yeniden çekmek yerine önbelleğe alın ve aramayı kendi tarafınızda, düğüm yolları üzerinde yapın.
Kategori özellikleri
Bir düğümün özellikleri GET /v3/application/seller-taxonomy/nodes/{taxonomy_id}/properties ucundan gelir. Bu uç da herkese açıktır.
| Özellik alanı | Ne söyler |
|---|---|
| property_id, display_name | Özelliğin kimliği ve okunur adı |
| is_required | Bu kategoride zorunlu mu |
| supports_variations | Envanterde varyasyon olarak kullanılabilir mi |
| supports_attributes | İlan özelliği olarak kullanılabilir mi |
| scales, possible_values | Ölçek seçenekleri ve hazır değerler |
Sorguya supports_variations=true eklerseniz yalnız varyasyon destekleyen özellikler döner. Hazır listede olmayan seçenekler için Etsy'nin özel varyasyonları vardır; property_id değerleri 513, 514 ve 516'dır ve en fazla üç varyasyon kullanılabilir.
Değer kimlikleri nasıl çalışır?
Renk gibi yaygın özelliklerde Etsy ortak değer kimlikleri kullanır. Belgeye göre ortak bir renk kimliği gönderdiğinizde Etsy bunu mağazanıza özgü bir kimliğe çevirir ve sonraki envanter okumalarında mağaza kimliği döner. Eşleştirme yaparken değer adını da saklamak bu yüzden işinizi kolaylaştırır.
İlan özelliği yazmak için PUT /v3/application/shops/{shop_id}/listings/{listing_id}/properties/{property_id} ucu value_ids ve values dizilerini birlikte ister.
Dikkat edilecekler
- Düğüm adları İngilizcedir. Türkçe kategori adlarıyla çalışıyorsanız kendi eşleştirme tablonuzu tutun.
- is_required alanı true olan özellikler, o kategorideki ilanlar için zorunludur; yayına almadan önce doldurun.
- Kategori sonradan updateListing ucunun taxonomy_id alanıyla değiştirilebilir. Varyasyon olarak kullanılabilen özellikler kategoriye bağlı olduğu için değişiklikten sonra envanteri de kontrol edin.
Sık sorulanlar
Etsy kategori ID nasıl bulunur?
GET /v3/application/seller-taxonomy/nodes ucu tüm ağacı döndürür. Doğru düğümü adına ve yoluna bakarak seçin; düğümün id değeri ilan isteğindeki taxonomy_id'dir.
Etsy kategori ağacında arama yapılabilir mi?
API'de arama ucu yok. Ağacı bir kez çekip önbelleğe alın ve aramayı kendi uygulamanızda düğüm adları ve yolları üzerinde yapın.
Hangi özellikler varyasyon olabilir?
Kategori özelliklerini supports_variations=true filtresiyle isteyin. Dönen özellikler envanterde renk, beden gibi varyasyon olarak kullanılabilir.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı