# Alibaba API - Get Alibaba product details(By URL)

## API Overview

- Product basic information (title/price/category)
- Product properties
- Main images/video
- Shop information (company name/shop rating etc.)
- Review information (rating star/review count)
- SKU attributes (name/thumbnail)
- SKU price and stock
- See More

## API URL

`POST https://api.tmapi.io/alibaba/item_detail_by_url`

## Request Parameters

### Body

> Content-Type: application/json

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| url | string | Product URL | true |

## Security Auth

> Please go to [Console-Account Center](https://console.tmapi.io/account/center) to get your apiToken.

> Add your apiToken to the request parameters. Please refer to the examples below.

## Request Example

```bash

curl --request POST 'https://api.tmapi.io/alibaba/item_detail_by_url?apiToken=xxxxxx' \
+  --header 'Content-Type: application/json' \
+  --data-raw '{
  "url": "https://www.alibaba.com/product-detail/Waterproof-IP65-18X20W-RGBWA-UV-LED_1601282281473.html"
}'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "item_id": 1601282281473,
    "title": "Waterproof IP65 18X20W RGBWA UV LED City Color Light LED Flood Wash Outdoor Wall Washer",
    "product_url": "https://www.alibaba.com/product-detail/Waterproof-IP65-18X20W-RGBWA-UV-LED_1601282281473.html",
    "category_path": [
      {
        "id": "39",
        "name": "Lights & Lighting"
      },
      {
        "id": "100010530",
        "name": "Outdoor Lighting"
      },
      {
        "id": "100010471",
        "name": "Wall Washers"
      }
    ],
    "category_id": 100010471,
    "currency": "USD",
    "product_props": [
      {
        "key": "Color Temperature(CCT)",
        "value": "rgbw, rgbwa, rgbwauv"
      },
      {
        "key": "Lamp Luminous Efficiency(lm/w)",
        "value": "60"
      },
      {
        "key": "Color Rendering Index(Ra)",
        "value": "80"
      },
      {
        "key": "Feature",
        "value": "water resistant, high brightness"
      }
    ],
    "main_imgs": [
      "https://sc04.alicdn.com/kf/H9d28a64c706941da91aa4519f6db5d46X.jpg",
      "https://sc04.alicdn.com/kf/H33dd1d85173c4bbc8da16a7579181e69A.jpg",
      "https://sc04.alicdn.com/kf/H4709656f3bf2456aaf0bfa6560811072M.jpg",
      "https://sc04.alicdn.com/kf/H81d9008e87834d4391a0fdee090bb253s.jpg",
      "https://sc04.alicdn.com/kf/Hd9d2dea0144641e58e937c51274b7690S.jpg",
      "https://sc04.alicdn.com/kf/Hba2d08b4e7374187baca1021e9d1ba71o.jpg"
    ],
    "video_url": "https://gv.videocdn.alibaba.com/icbu_vod_video/video_target/gv92-fa039fcd-8b397136-9270feec-6747/trans/87bf8231-1add-4000-a3df-fe15c96ff897-h264-hd.mp4?bizCode=icbu_vod_video",
    "price_info": {
      "price_text": "$225.00-240.00",
      "price_min": "184.5",
      "price_max": "196.8"
    },
    "tiered_price_info": null,
    "comment_count": 0,
    "customization_options": [
      {
        "custom_type": "Customized logo",
        "min_order_quantity": 100
      },
      {
        "custom_type": "Customized packaging",
        "min_order_quantity": 100
      },
      {
        "custom_type": "Graphic customization",
        "min_order_quantity": 100
      }
    ],
    "certifications": [],
    "review_info": {
      "rating_star": null,
      "review_count": 0
    },
    "sales_count": "",
    "shop_info": {
      "company_name": "Guangzhou Aegean Stage Lighting Equipment Co., Ltd.",
      "company_id": 247187876,
      "company_type": "Manufacturer,Trading Company",
      "company_region": "CN",
      "opening_years": "6",
      "seller_id": 2206940683594,
      "member_id": 239492970,
      "login_id": "cn1529888781soyo",
      "contact_name": "Ms. Yang",
      "shop_url": "https://aegeanlight.en.alibaba.com/index.html?from=detail&productId=1601282281473",
      "shop_rate": {
        "average_star": "4.7",
        "scores": [
          {
            "type": "supplier_services",
            "score": "4.7"
          },
          {
            "type": "shipping_time",
            "score": "4.6"
          },
          {
            "type": "product_quality",
            "score": "4.7"
          }
        ]
      },
      "response_time": "≤1h",
      "ontime_delivery_rate": "94.4%",
      "is_company_auth": false,
      "is_gold_supplier": false,
      "is_top_supplier": false,
      "is_dispatch_guaranteed": true
    },
    "delivery_info": {
      "area_from": "",
      "delivery_days": 3,
      "unit_weight": "11.000",
      "unit_size": "59X38X33"
    },
    "sku_props": [
      {
        "pid": "210190015",
        "prop_name": "Color",
        "values": [
          {
            "name": "Black",
            "vid": "3327837",
            "imageUrl": ""
          }
        ]
      },
      {
        "pid": "100008204",
        "prop_name": "Lamp Power(W)",
        "values": [
          {
            "name": "400",
            "vid": "75367941",
            "imageUrl": ""
          }
        ]
      },
      {
        "pid": "191286076",
        "prop_name": "Emitting Color",
        "values": [
          {
            "name": "RGBW",
            "vid": "190091395",
            "imageUrl": ""
          },
          {
            "name": "RGBWA",
            "vid": "-2",
            "imageUrl": ""
          },
          {
            "name": "RGBWA UV",
            "vid": "-5",
            "imageUrl": ""
          }
        ]
      }
    ],
    "skus": [
      {
        "skuid": "105996824973",
        "sale_price": "196.8",
        "origin_price": "240.0",
        "sample_price": "240.00",
        "stock": 20,
        "props_ids": "210190015:3327837;100008204:75367941;191286076:-5;",
        "props_names": "Color:Black;Lamp Power(W):400;Emitting Color:RGBWA UV;"
      },
      {
        "skuid": "105996824971",
        "sale_price": "184.5",
        "origin_price": "225.0",
        "sample_price": "225.00",
        "stock": 20,
        "props_ids": "210190015:3327837;100008204:75367941;191286076:190091395;",
        "props_names": "Color:Black;Lamp Power(W):400;Emitting Color:RGBW;"
      },
      {
        "skuid": "105996824972",
        "sale_price": "192.7",
        "origin_price": "235.0",
        "sample_price": "235.00",
        "stock": 20,
        "props_ids": "210190015:3327837;100008204:75367941;191286076:-2;",
        "props_names": "Color:Black;Lamp Power(W):400;Emitting Color:RGBWA;"
      }
    ],
    "min_order_quantity": 1,
    "unit": "pieces"
  }
}

```