RevUP Public API Documentation

GET /api/v1/brands?search=QUERY

Search for relatively close Depop brand names using fuzzy logic.

Query Params:

search (optional): partial or full brand name

Response:

{
  "result": [
    {
      "id": 123,
      "name": "Nike"
    },
    ...
  ]
}

GET /api/v1/vinted/categories?search=QUERY

Search through the Vinted category paths using fuzzy matching.

Query Params:

search (optional): partial or full category path (e.g. "women > shoes")

Response:

[
  {
    "id": 101,
    "full_readable_path": "Women > Shoes > Sneakers"
  },
  ...
]

POST /api/v1/ebay/get-product

Fetches product information for a given eBay item ID.

Request Body (JSON):

{
  "EbayAuthToken": "string",
  "ItemID": "string"
}

Successful Response:

{
  "success": true,
  "product": {
    "title": "Sample eBay Product",
    ...
  }
}

Error Response:

{
  "success": false,
  "error": "EbayAuthToken and ItemID are required",
  "error_code": "missing_fields"
}

POST /api/v1/depop/get-product

Fetches product data for a specific Depop listing ID.

Request Body (JSON):

{
  "ItemID": "string"
}

Successful Response:

{
  "status": "success",
  "product": {
    "title": "Sample Depop Product",
    ...
  }
}

Error Response:

{
  "status": "error",
  "message": "Missing required fields: id or ID"
}

POST /api/v1/shopify/login

Tests the user's Shopify access credentials.

Request Body (JSON):

{
  "shop_url": "mystore.myshopify.com",
  "access_token": "shpat_..."
}

Success Response:

{
  "success": true,
  "shop": {
    "shop": {
      "name": "My Store",
      ...
    }
  }
}

Error Response:

{
  "success": false,
  "error": {
    "error": "Invalid token"
  }
}

POST /api/v1/shopify/get-product

Fetches a product from your Shopify store by item ID.

Request Body (JSON):

{
  "store_domain": "mystore.myshopify.com",
  "shopify_access_token": "shpat_...",
  "ItemID": "123456789"
}

Success Response:

{
  "success": true,
  "product": {
    "title": "My Shopify Product",
    ...
  }
}

Error Response:

{
  "error": "Missing required fields: store_domain, shopify_access_token"
}