Developer docs
Which API?
New: Application API docs
Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.
Developer docs
New: Application API docs
Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.
Everything you need to integrate with the Gini v2 Third-Party API.
Read-only browsing of the product categories your store is granted. The list is scoped to the calling merchant's granted categories, not the whole platform tree. Use them to resolve the category_id / subcategory_id values required when creating or updating products. Both endpoints are GET-only and HMAC-signed; there are no create/update/delete category endpoints.
Returns every top-level category with its subcategories nested under each one, ordered newest-first. Not paginated — the full tree is returned in a single response.
/api/v2.0/third-party/categories
{
"data": [
{
"id": 3,
"name": "Electronics",
"slug": "electronics",
"is_active": 1,
"image_url": "https://s3.amazonaws.com/gini/categories/electronics.jpg",
"icon_url": "https://s3.amazonaws.com/gini/categories_icons/electronics.png",
"subcategories": [
{
"id": 12,
"name": "Audio",
"slug": "audio",
"is_active": 1,
"image": "https://s3.amazonaws.com/gini/subcategories/audio.jpg"
}
]
}
]
}Returns the subcategories belonging to the category identified by its slug, as a flat list ordered newest-first. Responds 404 when no category matches the slug.
/api/v2.0/third-party/categories/{slug}
{
"data": [
{
"id": 12,
"name": "Audio",
"slug": "audio",
"is_active": 1,
"image": "https://s3.amazonaws.com/gini/subcategories/audio.jpg"
},
{
"id": 13,
"name": "Phones",
"slug": "phones",
"is_active": 1,
"image": "https://s3.amazonaws.com/gini/subcategories/phones.jpg"
}
]
}