Top
Developers Your place to code all things handmade

Welcome to the Shopclues Developer Platform

We believe in code as craft. Join the community of developers, creators and build tools that enrich the ways you can shop, sell and connect with the India's largest merchant base most easily.

Get Started

Register, Upload, Search and Connect

Explore Shopclues' marketplace of over 8.5 million products from over 3.5 lakh merchants. Connect buyers with the items they'll love.

Learn More About Catalog Management

Login, Integrate and Create

Build the best tools for Shopclues merchants. Simply login, Integrate and start developing you own apps.

Learn More About Start Developing
<
>
Jump to: navigation, search

Get Category List

Access token is required to call this API.
Click here to know more about access token (OAUTH2).
METHOD = GET

Headers

?Field name ?Description ?Mandatory
Header - “Authorization” Token with token type to identify user. ”Bearer bc1f461de" Yes
Header - “Content-Type” ?Input Content Type will be “application/json" Yes

Fields description

Sr. No. Field Visibility Level Type Description
1. category_id public int Unique id assigned to every category.
2. category public string Name of the category.
3. is_leaf_category public boolean 'Y' If it's a leaf category.
4. has_options public boolean 'Y' If there are product variants available in that leaf category.


Details of response

??Variable ??Description
Status API status
1: Access successful.
0: Access failed.
Code Http response code - 2XX, 4XX, 5XX.
Message Textual response for the request.
Data List of categories with it's information.
Extra Information about results.
1: Count -- count of items in data.

Click Here to view the ShopClues SDK.

Get category collection

Lists all the available categories in the catalog with a description and a value to identify if it is a leaf category or not.
Production url:
http://developer.shopclues.com/api/v1/category
Sandbox url:
http://sandbox.shopclues.com/api/v1/category

Sample JSON response

{
  "status": 1,
  "code": 200,
  "message": "success",
  "data": [
    {
      "category_id": "85",
      "category": "Computers",
      "is_leaf_category": "N",
      "has_options": "N"
    },
    {
      "category_id": "87",
      "category": "Fashion",
      "is_leaf_category": "N",
      "has_options": "N"
    }
 ],
  "extra": {
    "count": 2
  }
}

Sample error response

{
  "status": 0,
  "code": 200,
  "message": "OK",
  "data": {
    "message": "Either leaf category id or Invalid category id"
  },
  "extra": {
    "count": 0
  }
}

Get sub category by category_id

Lists all the available sub categories in the catalog with a description and a value to identify if it is a leaf category or not.

Production URL:
http://developer.shopclues.com/api/v1/category/'''{category_id}'''
Sandbox URL:
http://sandbox.shopclues.com/api/v1/category/'''{category_id}'''


Sample JSON response

{
  "status": 1,
  "code": 200,
  "message": "success",
  "data": [
    {
      "category_id": "8689",
      "category": "Brand Store",
      "is_leaf_category": "Y",
      "has_options": "N"
    }
  ],
  "extra": {
    "count": 1,
    "category_title": "Laptops"
  }
}


Sample error response

{
  "status": 0,
  "code": 200,
  "message": "OK",
  "data": {
    "message": "Either leaf category id or Invalid category id"
  },
  "extra": {
    "count": 0
  }
}

Looking for ShopClues Apps?

Check out our new
App Gallery!

It's the best way to find cool and useful tools built upon Shopclues's API.