Catalog API Documentation

General information #

Base url #

https://partner.hustlegotreal.com/api/catalog

Authentification #

All calls must include a header “token” with the public token provided.

Example

“token”: “UzeLodERPrLhyNPYfk/nFanUfwcP19sibK-h7ToAXbrcqE69G1”

Request and Responses #

In case of a method Post, body data must be send in json format.

Responses will always be JSON objects that will contain next format.

FieldType 
statusstringValues: SUCCESS, ERROR
errorError TypeOnly if status is ERROR
resultVaries by endpointOnly if status is SUCCESS

Example #

{    
  "status":"ERROR",    
  "error":{
    "code":"ERR_02",
    "description":"Url empty or invalid"
  }
}

Endpoints #

Get #

PathMethod
/getGet

/get #

Method: Post

Get products from catalog. It will return 100 products.

Body request #

FieldTypeNotes
sourcesArray of int(OPTIONAL) Filter by sources. With Array empty or null, api will return products from any source available for the specified country
countrystringISO 3166: US, ES, DE, IT…
min_pricenumber(OPTIONAL)
max_pricenumber(OPTIONAL)
primePrimeReq Enum(OPTIONAL) Default value is 0.
titlestring(OPTIONAL) Filter by title
quantitynumber(OPTIONAL) By default 100

Examples #

{ 
  "country":"UK"
}
{ 
  "country":"UK",
  "sources":[1,25],
  "title": "hat",
  "min_price": 25,
  "max_price": 1520,
  "prime": 1,
  "quantity":50
}

Response result #

FieldTypeNotes
productsArray of Product type 

Example #

{    
  "products": [
    {
        "sourceId": 221,
        "url": "https://www.saleyee.com/dropship-garage-shed-5-tier-racking-storage-shelving-units-boltless-heavy-duty-shelves-blue-p36826.html",
        "title": "Garage Shed 5 Tier Racking Storage Shelving Units Boltless Heavy Duty Shelves Blue",
        "price": 27.92,
        "image": "Https://img-accelerate.saleyee.cn/Resources/GoodsImages/2022/202210/402d70a0-0202-4e2d-9aab-8c52a651f86b.Jpeg"
    },
    {
        "sourceId": 185,
        "url": "https://www.dropship-traders.co.uk/product/silverline-1-2-dr-air-impact-wrench/",
        "title": "Silverline 1/2? Dr Air Impact Wrench",
        "price": 36.44,
        "image": "Https://www.dropship-traders.co.uk/wp-content/uploads/2021/07/719770_1.jpg"
    },
    {
        "sourceId": 185,
        "url": "https://www.dropship-traders.co.uk/product/clarke-cht733-professional-mortar-gun-set/",
        "title": "Clarke CHT733 Professional Mortar Gun Set",
        "price": 20.9,
        "image": "Https://www.dropship-traders.co.uk/wp-content/uploads/2021/07/CHT733_2.jpg"
    }
  ]
}

Types #

Error Type #

FieldTypeNotes
codestringValues contained in Error List
descriptionstring 

Example #

{
  "code":"ERR_05",
  "description":"Unknown error"
}

Error List #

CodeDescription
CodeDescription
ERR_01Your Token is wrong
ERR_02Url empty or invalid
ERR_03Country wrong or invalid
ERR_04Unable to obtain product information
ERR_05Unknown error
ERR_06Supplier or country not recognised. Try looking for this supplier in a different country
ERR_07Wrong request key
ERR_08Product information is not yet available
ERR_09Product doesn’t exists

PrimeReq enum #

MeaningValue (Amazon)
0Not prime and prime
1Only prime

Product Type #

FieldTypeNotes
sourceIdnumber 
urlstring 
titlestring 
pricenumber 
imagestring 

Example #

{
    "sourceId": 185,
    "url": "https://www.dropship-traders.co.uk/product/neilsen-ct0906-12-piece-1-4-dr-multi-coloured-sockets/",
    "title": "Neilsen CT0906 12 Piece 1/4? Dr – Multi-coloured Sockets",
    "price": 15.45,
    "image": "Https://www.dropship-traders.co.uk/wp-content/uploads/2021/07/CT0906_1-1.jpg"
}

Funciona con BetterDocs

Scroll hacia arriba