Get Taxonomy
  • 1 Minute to read

    Get Taxonomy


      Article summary

      GET /taxonomy - Get Active and Previous Taxonomies

      Use this API to fetch the currently active version of your Yahoo taxonomy or to get a list of previously uploaded taxonomies. Table below lists URIs supported for querying taxonomies:

      URI

      Description

      GET /taxonomy

      Use this API to fetch the currently active version of your Taxonomy. It returns an application/json response identical to the data part of a POST /taxonomy call.

      GET /taxonomy/meta

      Gets the metadata corresponding to last uploaded taxonomy.

      Example - Get Active Taxonomy

      Request

      GET /v1/taxonomy HTTP/1.1 Host: datax.yahooapis.com

      Response

      HTTP/1.1 200 OK
      Content-Type: application/json;charset=UTF-8 [
      {
      "id" : "YR1194",
      "name" : "Baby Products", "type" : "SEGMENT"
      }
      ]

      Example - List previous taxonomies

      Request

      GET /v1/taxonomy/meta?history=true&limit=2 HTTP/1.1 Host:
      datax.yahooapis.com

      Response

      HTTP/1.1 200 OK
      Content-Type: application/json;charset=UTF-8 [{
              "resourceType" : "datax-taxonomy",
              "resourceId" : "130815T013759Z662599033",
              "createTime" : "2013-14-05T17:47:32Z",
              "description" : "YaRetail Pilot Taxonomy", "links" :
              [{
                      "rel"   : "self",
                      "href" : "https://datax.yahooapis.com/v1/link/s/ozQ8sfj7EJV-"
              },{
                      "rel"   : "describes",
                      "href" : "https://datax.yahooapis.com/v1/link/rw5fasr4akhaQ-"
              }],
              "status" : {
                      "state" : "PROCESSING",
                      "lastUpdateTime" : "2013-14-05T17:47:32Z"
                      }
              },
              {
              "resourceType" : "datax-taxonomy",
              "resourceId" : "130715T013759Z212573056",
              "createTime" : "2013-14-05T17:47:32Z",
              "description" : "YaRetail Pilot Taxonomy",
      
              "links" : [{
                      "rel"   : "self",
                      "href" : "https://datax.yahooapis.com/v1/link/s/IzzB5VWqTS073wGYDuuMc-"
              },{
                      "rel"   : "describes",
                      "href" : "https://datax.yahooapis.com/v1/link/zdx6gB7PAyCbRrs2aa-"
              }],
              "status" : {
                      "state" : "ERROR",
                      "lastUpdateTime" : "2013-14-05T17:47:31Z",
                      "errors" : [{
                              "code" : "DATAX-1001",
                              "message" : "Input Taxonomy failed schema validation"
                      }]
              }
      }]


      Was this article helpful?

      What's Next