Trade

Search Suppliers

Beta
POST

This endpoint is in beta and is subject to change. It is provided for early access and testing purposes only.
Search for a supplier. Please note, searches are limited to a maximum of 10,000 results.

Query parameters

limitintegerOptional
A limit on the number of objects to be returned with a range between 1 and 100. Defaults to 100.
offsetintegerOptional
Number of results to skip before returning response. Defaults to 0.

Request

This endpoint expects an object.
q
stringRequired
Query term. The syntax for the query parameter follows elasticsearch simple query string syntax. The includes the ability to use search operators and to perform nested queries. Must be url encoded.
filter
objectOptional
Filters to be applied to search query to limit the result-set.
facets
booleanOptional
Whether or not to return search facets in results giving counts by field. Defaults to false.

Response

This endpoint returns an object
data
list of objects
limit
integer
next
boolean
offset
integer
size
object
POST
1curl -X POST "https://api.sayari.com/v1/trade/search/suppliers?limit=1" \
2     -H "Authorization: Bearer <token>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "q": "rum"
6}'
200
Successful
1{
2  "data": [
3    {
4      "addresses": [],
5      "attribute_count": {
6        "name": 1
7      },
8      "closed": false,
9      "countries": [],
10      "degree": 2523,
11      "entity_url": "/v1/entity/LvKN1AA74GQ289vydvYgtg",
12      "id": "LvKN1AA74GQ289vydvYgtg",
13      "identifiers": [],
14      "label": "RedbusAvto OU",
15      "metadata": {
16        "shipments": 2522,
17        "hsCodes": [
18          {
19            "key": "870323",
20            "doc_count": 1292,
21            "value": "Vehicles; with only spark-ignition internal combustion reciprocating piston engine, cylinder capacity over 1500 but not over 3000cc",
22            "value_simple": "Cars & Passenger Vehicles"
23          },
24          {
25            "key": "8703239013",
26            "doc_count": 1288,
27            "value": "Vehicles; with only spark-ignition internal combustion reciprocating piston engine, cylinder capacity over 1500 but not over 3000cc",
28            "value_simple": "Cars & Passenger Vehicles"
29          },
30          {
31            "key": "870332",
32            "doc_count": 509,
33            "value": "Vehicles; with only compression-ignition internal combustion piston engine (diesel or semi-diesel), cylinder capacity over 1500 but not over 2500cc",
34            "value_simple": "Cars & Passenger Vehicles"
35          },
36          {
37            "key": "8703329030",
38            "doc_count": 508,
39            "value": "Vehicles; with only compression-ignition internal combustion piston engine (diesel or semi-diesel), cylinder capacity over 1500 but not over 2500cc",
40            "value_simple": "Cars & Passenger Vehicles"
41          },
42          {
43            "key": "870322",
44            "doc_count": 472,
45            "value": "Vehicles; with only spark-ignition internal combustion piston engine, cylinder capacity over 1000 but not over 1500cc",
46            "value_simple": "Cars & Passenger Vehicles"
47          }
48        ],
49        "latestShipmentDate": "2023-10-27"
50      },
51      "pep": false,
52      "psa_count": 0,
53      "related_entities_count": 2523,
54      "relationship_count": {
55        "shipper_of": 2522,
56        "ships_to": 1
57      },
58      "risk": {},
59      "sanctioned": false,
60      "source_count": {
61        "96c06a5a03b61b91324c7e05b3114fb6": {
62          "count": 2522,
63          "label": "Ukraine Imports & Exports (January 2023 - Present)"
64        }
65      },
66      "trade_count": {
67        "sent": 20,
68        "received": 33308
69      },
70      "type": "company",
71      "user_attribute_count": {},
72      "user_record_count": 0,
73      "user_related_entities_count": 0,
74      "user_relationship_count": {}
75    }
76  ],
77  "limit": 1,
78  "next": true,
79  "offset": 0,
80  "size": {
81    "count": 5541,
82    "qualifier": "eq"
83  }
84}
Built with