Products
GET

Rank US buyers by product specialization

1 per 10 records

Find US companies most relevant to a product keyword (relevance / specialization ranking).

Related:Rank buyers & suppliers by product

Parameters#

Path parameters

  • productstringrequired

Query parameters

  • page_sizenumberoptionaldefault 10

    Number of returned results

  • offsetnumberoptionaldefault 0

    Results starting position

  • countriesstringoptional

    Comma-separated list of supplier countries

  • exclude_countriesstringoptional

    Comma-separated list of supplier countries to exclude

  • fieldsstringoptional

    Comma-separated list of response fields to keep on each returned record. Every other field on the record is omitted. Names the record does not have are ignored. The envelope (requestCost, creditsRemaining, executionTime, totalCount) is always returned in full. Cannot be combined with exclude. Leave this out for the full record.

  • excludestringoptional

    Comma-separated list of response fields to drop from each returned record. Every other field is kept. Cannot be combined with fields. Leave this out for the full record.

  • formatstringoptionaldefault json

    Response encoding. Defaults to json. Pass toon to receive TOON — the same data in a compact, token-efficient text form intended for LLM prompts. Error responses are always JSON.

    one ofjsontoon

fields, exclude, and format work the same way on every endpoint — Response shaping has worked examples.

Response#

A ranked list of US companies most relevant to that product keyword.

Response shape
{
  "requestCost": 1,
  "creditsRemaining": 9998.5,
  "data": [
    {
      "company_link": "/company/fashion-footwear",
      "company_name": "Fashion Footwear",
      "matching_shipments": 967,
      "specialization": 89.87,
      "company_total_shipments": 1076,
      "company_experience": 3.3,
      "product_description": ["Shoes", "Ladies Shoes", "Mens Shoes"],
      "company_suppliers": ["Wenzhou Qimao Import & Export"]
      // …3 more fields
    }
  ],
  "executionTime": "224ms"
}

Top-level fields#

  • data — an array of matching records
  • requestCost — Data credits used for this call (0 if none)
  • creditsRemaining — Your data credit balance after the call
  • executionTime — How long the request took

Fields on each item in data#

FieldExample
11 fields
  • company_namestringFashion Footwear
  • matching_shipmentsnumber967

    How many of this supplier's shipments matched the product you searched.

  • specializationnumber89.87
  • company_total_shipmentsnumber1076
  • company_experiencenumber3.3
  • product_descriptionstring[]["Shoes", "Ladies Shoes", "Mens Shoes"]
  • company_suppliersstring[]["Wenzhou Qimao Import & Export"]
  • total_suppliersnumber1
  • weightnumber23906858
  • relevance_scorenumber98.99

Errors#

Failures come back as JSON with a statusCode and message. The ones worth handling here are 401 (bad or missing key), 403 (out of credits), and 404 (no such record). See all error responses.