商品名からeBayのカテゴリーをサジェストする方法 (NEW API)

eBayでは商品を出品する際に商品のカテゴリーを選択する必要があります。

多くのカテゴリーの中から正しいカテゴリーを選定する事が難しい場合がありますが、
eBayでは商品名からその商品のカテゴリーの候補を出力してくれるAPIを用意しています。

その使用方法を紹介します。

 

Taxonomy APIgetCategorySuggestionsコールを使って候補を出力しますが、
その前に自身の国のcategoryTreeIdを取得する必要があります。

getDefaultCategoryTreeIdコールを使って、categoryTreeIdを取得します。

 

以下のキーに値をセットしてPOSTでリクエストします。

[token] = 取得したtoken

[id] = marketplace_id

※marketplace_idは以下のURLを参考にして下さい。

https://developer.ebay.com/api-docs/commerce/taxonomy/static/supportedmarketplaces.html

 

 

するとレスポンスは下記のように取得されます。

{“data”:”999″}

※999はcategoryTreeId

 

 

取得したcategoryTreeIdを使用して、getCategorySuggestionsコールを使用します。

以下のキーに値をセットしてPOSTでリクエストします。

 

[token] = 取得したtoken

[categoryTreeId] = getDefaultCategoryTreeIdで取得したcategoryTreeId

[q] = 商品名

 

 

するとレスポンスは下記のように取得されます。

※marketplace_id=eBay_US、商品名=DVDでコールした場合

 

{
  "data": [
    {
      "categoryTreeNodeLevel": 2,
      "categoryName": "DVDs & Blu-ray Discs",
      "categoryId": "617",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "DVDs & Movies",
          "categoryId": "11232",
          "categoryTreeNodeLevel": 1
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 4,
      "categoryName": "DVD",
      "categoryId": "1273",
      "categoryTreeNodeAncestors": [ 
        {
          "categoryName": "Everything Else",
          "categoryId": "99",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Adult Only",
          "categoryId": "319",
          "categoryTreeNodeLevel": 2
        },
        {
          "categoryName": "DVDs & Movies",
          "categoryId": "4800",
          "categoryTreeNodeLevel": 3
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 3,
      "categoryName": "Other DVD & Movie Whlsl Lots",
      "categoryId": "46771",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "DVDs & Movies",
          "categoryId": "11232",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Wholesale Lots",
          "categoryId": "31606",
          "categoryTreeNodeLevel": 2
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 3,
      "categoryName": "DVDs, Videos & Books",
      "categoryId": "73991",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "Sporting Goods",
          "categoryId": "888",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Boxing, Martial Arts & MMA",
          "categoryId": "179767",
          "categoryTreeNodeLevel": 2
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 3,
      "categoryName": "Magazine Back Issues",
      "categoryId": "613",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "Everything Else",
          "categoryId": "99",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Adult Only",
          "categoryId": "319",
          "categoryTreeNodeLevel": 2
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 3,
      "categoryName": "DVDs & Blu-ray Discs",
      "categoryId": "46760",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "DVDs & Movies",
          "categoryId": "11232",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Wholesale Lots",
          "categoryId": "31606",
          "categoryTreeNodeLevel": 2
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 4,
      "categoryName": "Other Anime Collectibles",
      "categoryId": "1345",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "Collectibles",
          "categoryId": "1",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Animation Art & Characters",
          "categoryId": "13658",
          "categoryTreeNodeLevel": 2
        },
        {
          "categoryName": "Japanese, Anime",
          "categoryId": "11118",
          "categoryTreeNodeLevel": 3
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 4,
      "categoryName": "VHS",
      "categoryId": "321",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "Everything Else",
          "categoryId": "99",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Adult Only",
          "categoryId": "319",
          "categoryTreeNodeLevel": 2
        },
        {
          "categoryName": "DVDs & Movies",
          "categoryId": "4800",
          "categoryTreeNodeLevel": 3
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 3,
      "categoryName": "CD, DVD & Blu-ray Drives",
      "categoryId": "131542",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "Computers/Tablets & Networking",
          "categoryId": "58058",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "Drives, Storage & Blank Media",
          "categoryId": "165",
          "categoryTreeNodeLevel": 2
        }
      ]
    },
    {
      "categoryTreeNodeLevel": 3,
      "categoryName": "DVD & Blu-ray Players",
      "categoryId": "175711",
      "categoryTreeNodeAncestors": [
        {
          "categoryName": "Consumer Electronics",
          "categoryId": "293",
          "categoryTreeNodeLevel": 1
        },
        {
          "categoryName": "TV, Video & Home Audio",
          "categoryId": "32852",
          "categoryTreeNodeLevel": 2
        }
      ]
    }
  ]
}

詳しくはAPI下記のAPI Referenceを確認してください。

https://developer.ebay.com/api-docs/commerce/taxonomy/resources/methods