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