# DHgate API - Search for DHgate products by keywords or category

## API Overview

- Get a list of products based on keyword
- Total number of products
- Product details
- See More

## API URL

`GET https://api.tmapi.io/dhgate/search/items`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| page | integer | Page number<br/>Default value: 1 | false |
| keywords | string | Search keywords | true |
| sort | string | Optional values: `sales`, `price_up`, `price_down`, `default`, `newest`, `rating`<br/>Default value: default | false |
| country | string | Default value: us | false |
| currency | string | Default value: USD | false |
| language | string | Default value: en | false |
| free_shipping | boolean | Filter: Free shipping | false |
| high_rating | boolean |  | false |

## 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 GET 'https://api.tmapi.io/dhgate/search/items?apiToken=xxxxxx&page=1&keywords=&sort=default&country=us&currency=USD&language=en'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 40,
    "total_count": 240000,
    "has_next_page": true,
    "sort": "default",
    "filters": {},
    "items": [
      {
        "item_id": "1028540574",
        "product_url": "https://www.dhgate.com/product/2024new-cross-body-evening-bags-mukeup-bags/1028540574.html",
        "title": "2025New Cross Body Evening Bags mukeup bags For Women Plaid Jelly Bag Candy Color Flap Mini Designed Ladies Tote Messenger",
        "img": "https://www.dhresource.com/webp/m/300x300/f2/albu/g18/M00/37/05/rBVapWHMU6aAcHQxAACMufvZC5M525.jpg",
        "price": "39.72",
        "price_info": {
          "price_text": "US $39.72 - 66.86 ",
          "price_min": "39.72",
          "price_max": "66.86",
          "origin_price_min": "44.13",
          "origin_price_max": "74.29"
        },
        "currency": "USD",
        "unit": "Piece",
        "comment_count": 6,
        "review_info": {
          "review_count": 6,
          "average_star": "5.0"
        },
        "sales_count": "54",
        "min_order_qty": 1,
        "shop_info": {
          "shop_id": "22020361",
          "shop_name": "dg15655520273",
          "shop_url": "https://www.dhgate.com/store/22020361#listing_store-1"
        },
        "is_ad": false,
        "refund_guarantee": false
      },
      {
        "item_id": "1022505598",
        "product_url": "https://www.dhgate.com/product/pacific-chill-perfume-valentine-s-day-limited/1022505598.html",
        "title": "Best Perfume AFTERNOON SWIM PACIFIC CHILL LOVERS Fragrance Attrape Reves Perfume Sables Rose On the Beach Eau de Parfum 3.4 oz 100 ml Cologner Spray",
        "img": "https://img4.dhresource.com/webp/m/300x300/f3/albu/jc/s/11/0aef3937-a5be-43e5-81e1-0f392f49e114.jpg",
        "price": "27.92",
        "price_info": {
          "price_text": "US $27.92 - 50.66 ",
          "price_min": "27.92",
          "price_max": "50.66",
          "origin_price_min": "31.02",
          "origin_price_max": "56.29"
        },
        "currency": "USD",
        "unit": "Piece",
        "comment_count": 48,
        "review_info": {
          "review_count": 48,
          "average_star": "4.5"
        },
        "sales_count": "205",
        "min_order_qty": 1,
        "shop_info": {
          "shop_id": "20415788",
          "shop_name": "brandskincare",
          "shop_url": "https://www.dhgate.com/store/20415788#listing_store-2"
        },
        "is_ad": false,
        "refund_guarantee": false
      }
    ]
  }
}

```