Taxonomy API

For US and Canada

Use Taxonomy API endpoint https://partner-api.groupon.com

Introduction back to top

Taxonomy API allows to retrieve taxonomy category details. Either you can retrieve all the categories starting from root categories or specify a category from where all the child categories will be retrieved. ClientId is used for authentication of request. "clientId" is "Reporting API key" which you can find in the Account Profile under "Business Details" section when you log into to your GPN account.

Authorization Steps back to top

The Transaction API uses authorization tokens as well as client id for authentication. Check Account Profile to get your authorization token. We support one active token per affiliate. This token is unique to you and this token will be valid until you regenerate another token from Account Profile. There are two options for authorization.

1. Non salted authorization token (less secure option):

This option consists of passing the authorization token as an HTTP header.

curl -X GET 'https://partner-api.groupon.com/v3/taxonomy?clientId=[affiliate_client_id] -H 'x-auth-token:[your-authorization-token]' -H 'x-auth-version: SEC1'

2. Salted authorization token (Secure and Recommended):

This option guarantees that each request will have a unique authorization token by concatenating the current timestamp to your secret token and hashing it using SHA256.

curl -X GET 'https://partner-api.groupon.com/v3/taxonomy?clientId=[affiliate_client_id] -H 'x-auth-version: SEC2' -H 'x-auth-token:{hashToken}' -H 'x-auth-timestamp: {timestampUTC}'

hashToken = sha256Hex{secretToken + timestampUTC}
secretToken = [your-authorization-token]
timestampUTC = current UTC timestamp in format YYYY-MM-DDTHH:mm:SS


Please do reach out to us if you're facing any issues integrating with the API.

Supports back to top

Format : JSON

Sample Callsback to top

When no category guid is passed in parameter, retrieves all the categories underneath root categories

https://partner-api.groupon.com/v3/taxonomy?clientId=[affiliate_client_id]

When category guid is passed in parameter, retrieves all categories underneath passed category

https://partner-api.groupon.com/v3/taxonomy?clientId=[affiliate_client_id]&categoryGuid=f63665f0-a149-474d-897b-12093272194bD

Sample Responseback to top

URL Parametersback to top

Parameter Definition Required
clientId Specific Affiliate clientId. "clientId" is "Reporting API key" which you can find in the Account Profile under "Business Details" section when you log into to your GPN account. Yes
categoryGuid Start category guid below which all child categories will be fetched. When not passed all categories below root categories will be returned.
Example: 3d0ecb8d-52cc-4bf3-b027-bd819368b9f9
No

Response Parametersback to top

Field Description
guid Category unique id
description Category hierarchy from root category like "Local > Automotive > Parking"
name Name of category
parent Parent category guid(unique id)
children List of child categories guid(unique id)

Error Messageback to top

Sample Response wrong categoryGuid

Sample response wrong clientId