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

## API Overview

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

## API URL

`POST https://api.tmapi.io/dhgate/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/dhgate/item_detail_by_url?apiToken=xxxxxx' \
+  --header 'Content-Type: application/json' \
+  --data-raw '{
  "url": ""
}'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "item_id": 1038443132,
    "title": "Women's Original Design Embroidered Shoulder Tote Bag Ideal for Beaches & Commuting",
    "product_url": "https://www.dhgate.com/product/women-s-original-design-embroidered-shoulder/1038443132.html",
    "category_path": [
      {
        "id": "107",
        "name": "Bags, Luggage & Accessories"
      },
      {
        "id": "107011",
        "name": "Fashion Bags"
      },
      {
        "id": "107011002",
        "name": "Shoulder Bags"
      }
    ],
    "category_id": 107011002,
    "currency": "USD",
    "price_info": {
      "price_text": "$37.81 - $39.6",
      "price_min": "37.81",
      "price_max": "39.6"
    },
    "sales_count": 0,
    "min_order_quantity": 1,
    "unit": "piece",
    "main_imgs": [
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/71f3abe9-b529-4bc3-a4ca-169dd1a2e108.jpg",
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/199ca331-416c-49df-aa11-0040adca24fc.jpg",
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/eda39c69-e76a-4d9d-a03e-2db7ca162f36.jpg",
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/dca3c67f-8bb2-4bbd-929d-d6e5194665cf.jpg",
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/04b68469-0d63-41ee-ae3d-43c7af3fa855.jpg",
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/6be86741-8606-4497-88b9-b6bb50431ce3.jpg",
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/c4a1e7c9-42de-4762-8e08-bf305dd77b63.jpg",
      "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/3e1395b8-2914-49b4-ab15-3c0c8b491003.jpg"
    ],
    "video_url": null,
    "highlights": [
      "Crafted with premium cotton fabric, this embroidered shoulder tote bag offers durability while maintaining breathability, making it perfect for both casual outings and daily commuting.",
      "This versatile tote comes equipped with multiple compartments including spacious pockets tailored specifically for organizing essentials like sunscreen, phone, wallet, and keys during beach trips or commutes.",
      "Featuring an elegant and intricate embroidery design, our womens tote adds a touch of sophistication to your beach attire or everyday ensemble, setting you apart with its distinctive charm.",
      "Available in vibrant colors, this embossed tote seamlessly blends functionality with fashion-forward aesthetics, allowing you to express individuality effortlessly wherever you go.",
      "Adorned with adjustable straps, the ergonomic structure ensures comfort over extended periods whether carrying groceries, books, or travel accessoriesideal for those who prioritize ease without sacrificing style."
    ],
    "product_props": [
      {
        "key": "Type",
        "value": "Shoulder Bags"
      },
      {
        "key": "Gender",
        "value": "Women"
      },
      {
        "key": "Pattern",
        "value": "Artwork"
      },
      {
        "key": "Material",
        "value": "Canvas"
      },
      {
        "key": "Holiday",
        "value": "Christmas Valentine's Day Mother's Day"
      },
      {
        "key": "Occasion",
        "value": "Daily Outfit"
      },
      {
        "key": "Style",
        "value": "Bohemian"
      },
      {
        "key": "Closure Type",
        "value": "Hasp"
      },
      {
        "key": "Lining Material",
        "value": "Polyester"
      },
      {
        "key": "Size",
        "value": "Large(>50cm)"
      }
    ],
    "shop_info": {
      "seller_name": "深圳市延永商务服务有限公司",
      "user_id": "8aaabade9193576f0191a23342cc6d7a",
      "shop_id": 22015686,
      "shop_logo": "https://img4.dhresource.com/webp/m/f3/user/jc/s/27/22736538-3d2f-4780-858f-bac1207a67d0.jpg",
      "company_name": "深圳市延永商务服务有限公司",
      "company_region": "CN",
      "items_count": 1899,
      "positive_feedback": "95.3%",
      "company_desc": "",
      "total_employees": "Less than 5 People",
      "opening_years": 1,
      "shop_url": "https://www.dhgate.com/store/22015686"
    },
    "sku_props": [
      {
        "pid": "700516",
        "prop_name": "Color",
        "values": [
          {
            "name": "Pink",
            "vid": "986855",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/0cad019d-06bf-4f07-9d7e-a32fc356612a.jpg"
          },
          {
            "name": "Black",
            "vid": "986857",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/c7fffe54-55c0-4d6a-bb53-5f27efa0a25d.jpg"
          },
          {
            "name": "Orange",
            "vid": "986864",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/90df0527-470e-4005-aa42-c9d0463c4f0e.jpg"
          },
          {
            "name": "Purple",
            "vid": "986865",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/b2d09d8d-4091-4e44-88e7-17cdb48431e4.jpg"
          },
          {
            "name": "Yellow",
            "vid": "986867",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/8495ef07-8f1c-4cb6-890c-23f2923c7760.jpg"
          },
          {
            "name": "Coffee",
            "vid": "1334349",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/55418985-c80e-4b3b-9c7b-0427ad64e9e7.jpg"
          },
          {
            "name": "Army Green",
            "vid": "2052198",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/99675e05-f2d9-4be5-ba8b-9823580cf147.jpg"
          },
          {
            "name": "Sky Blue",
            "vid": "2052611",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/3e1395b8-2914-49b4-ab15-3c0c8b491003.jpg"
          },
          {
            "name": "Light Blue",
            "vid": "1",
            "imageUrl": "https://img4.dhresource.com/webp/m/0x0/f3/albu/jc/n/18/c4a1e7c9-42de-4762-8e08-bf305dd77b63.jpg"
          }
        ]
      }
    ],
    "skus": [
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:986855",
        "props_names": "Color:Pink"
      },
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:986857",
        "props_names": "Color:Black"
      },
      {
        "skuid": "1330041162911748145",
        "sale_price": "39.6",
        "origin_price": "44.49",
        "stock": 100000,
        "props_ids": "700516:986864",
        "props_names": "Color:Orange"
      },
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:986865",
        "props_names": "Color:Purple"
      },
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:986867",
        "props_names": "Color:Yellow"
      },
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:1334349",
        "props_names": "Color:Coffee"
      },
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:2052198",
        "props_names": "Color:Army Green"
      },
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:2052611",
        "props_names": "Color:Sky Blue"
      },
      {
        "skuid": null,
        "sale_price": "",
        "origin_price": "",
        "stock": null,
        "props_ids": "700516:1",
        "props_names": "Color:Light Blue"
      }
    ],
    "tiered_price_info": {
      "begin_num": 1,
      "prices": [
        {
          "begin_num": "1",
          "price": "39.6"
        },
        {
          "begin_num": "24",
          "price": "37.81"
        }
      ]
    },
    "promotions": [
      {
        "content": "Get US $1 off on orders over US $3",
        "type": "New Buyer Coupon"
      },
      {
        "content": "Get US $3 off on orders over US $45",
        "type": "New Buyer Coupon"
      },
      {
        "content": "Get US $6 off on orders over US $85",
        "type": "New Buyer Coupon"
      }
    ]
  }
}

```