Piloterr

Alibaba Product

Alibaba Product API. Fetch a full B2B product page by URL or product ID with optional locale subdomain. Browser rendering returns tiered pricing, seller profile and lead times.

Credit cost: 2 credits per call

GET
/v2/alibaba/product

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full Alibaba product URL or numeric product ID.

Examples (URL):

https://www.alibaba.com/product-detail/Custom-Neon-Light-Acrylic-Neon-Sign_1601175379813.html

Examples (ID):

1601175379813

Bare IDs resolve on www.alibaba.com. Use subdomain=portuguese for a localized PDP.

Discover listing_url values with Alibaba Search.

subdomain?string

Locale subdomain when query is a bare product ID, or to override the host on a product URL.

Examples:

portuguese
french.alibaba.com

Defaults to www when omitted on numeric IDs.

return_page_source?boolean

When true, return the rendered HTML as {"result": "..."} instead of structured JSON. Defaults to false.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/alibaba/product?query=string"
{
  "url": "https://portuguese.alibaba.com/product-detail/Custom-Neon-Light-Acrylic-Neon-Sign_1601175379813.html",
  "price": {
    "max": 17.58,
    "min": 13.16,
    "unit": "Peça",
    "display": "€ 13,16- 17,58",
    "quantity_prices": [
      {
        "price": 17.58,
        "display": "€ 17,58",
        "price_usd": 19.9,
        "max_quantity": 49,
        "min_quantity": 1
      },
      {
        "price": 16.7,
        "display": "€ 16,70",
        "price_usd": 18.9,
        "max_quantity": 99,
        "min_quantity": 50
      },
      {
        "price": 15.81,
        "display": "€ 15,81",
        "price_usd": 17.9,
        "max_quantity": 499,
        "min_quantity": 100
      },
      {
        "price": 13.16,
        "display": "€ 13,16",
        "price_usd": 14.9,
        "min_quantity": 500
      }
    ]
  },
  "title": "Letreiro Neon Personalizado em Acrílico, Letreiro LED Neon para Branding de Lojas, Letreiro Neon por Atacado, Letreiro Iluminado LED Personalizado",
  "trade": {
    "lead_time": [
      {
        "max_quantity": 50,
        "min_quantity": 1,
        "process_period_days": 3
      },
      {
        "max_quantity": 500,
        "min_quantity": 51,
        "process_period_days": 7
      },
      {
        "max_quantity": 1000,
        "min_quantity": 501,
        "process_period_days": 15
      }
    ],
    "sales_volume": "890 vendido(s)"
  },
  "images": [
    "https://sc04.alicdn.com/kf/Hb0b375797bc04466a0b0899d8c3c1349P.jpg",
    "https://sc04.alicdn.com/kf/H6ce47c97d3f64748833a0d49e35f20efK.jpg",
    "https://sc04.alicdn.com/kf/Hde96e67f4ee8446c93b4c05a0aeaec1bc.jpg",
    "https://sc04.alicdn.com/kf/Hd15d7d3495f14440b8e4e9285d39250aS.jpg",
    "https://sc04.alicdn.com/kf/H53b4d1aacb0344fbbe6b5e3b04099f1eg.jpg",
    "https://sc04.alicdn.com/kf/Hf018053ccf77428484059bf8f4ba267d7.jpg"
  ],
  "seller": {
    "years": "7",
    "country": "CN",
    "company_id": 247837230,
    "profile_url": "https://custombox.en.alibaba.com/pt_PT/company_profile.html",
    "company_name": "Shenzhen Boxin Electronics Co., Ltd.",
    "is_gold_supplier": true
  },
  "attributes": [
    {
      "name": "Fonte de luz",
      "value": "Tubo Do DIODO EMISSOR de, LEVOU Neon, Tiras de LED, Luz de néon"
    },
    {
      "name": "Fonte de alimentação",
      "value": "Dc dc dc, Plugue, Transformador"
    },
    {
      "name": "Garantia",
      "value": "2 Years, 2 Anos"
    },
    {
      "name": "Material",
      "value": "Acrílico + luz neon"
    },
    {
      "name": "Classificação IP",
      "value": "IP68"
    },
    {
      "name": "Tensão",
      "value": "DC12V/24V"
    }
  ],
  "product_id": 1601175379813,
  "locale_host": "portuguese.alibaba.com"
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}