Search Buyers

POST

/v1/trade/search/buyers

POST

1 curl -X POST "https://api.sayari.com/v1/trade/search/buyers?limit=1" \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "filter": {
6     "departure_country": [
7       "DEU"
8     ],
9     "arrival_country": [
10       "RUS"
11     ],
12     "hs_code": [
13       "854231"
14     ],
15     "arrival_date": [
16       "2024-01 TO 2024-10"
17     ]
18   }
19 }'

Play

200Successful

1 {
2   "data": [
3     {
4       "addresses": [
5         "119270, , Г.МОСКВА, УЛ.ХАМОВНИЧЕСКИЙ ВАЛ,Д.12,ЭТ.2,ПОМ.Х,КОМ.15,",
6         "119270, , Г.МОСКВА, УЛ.ХАМОВНИЧЕСКИЙ ВАЛ,Д.12,ЭТ12,ПОМ.Х,КОМ.15,",
7         "119270, ГОРОД МОСКВА, УЛ. ХАМОВНИЧЕСКИЙ ВАЛ, Д. 12, ЭТАЖ 2 ПОМ Х КОМ 15"
8       ],
9       "attribute_count": {
10         "name": 3,
11         "business_purpose": 10,
12         "identifier": 7,
13         "additional_information": 2,
14         "country": 2,
15         "shares": 1,
16         "status": 1,
17         "address": 4,
18         "financials": 3
19       },
20       "closed": false,
21       "countries": [
22         "RUS"
23       ],
24       "degree": 195,
25       "entity_url": "/v1/entity/uWNWgzX-Kvp1j-WeXKmLQw",
26       "id": "uWNWgzX-Kvp1j-WeXKmLQw",
27       "identifiers": [
28         {
29           "value": "7705856072",
30           "type": "ru_inn",
31           "label": "Ru Inn"
32         },
33         {
34           "value": "5087746065578",
35           "type": "ru_ogrn",
36           "label": "Ru Ogrn"
37         },
38         {
39           "value": "770401001",
40           "type": "ru_kpp",
41           "label": "Ru Kpp"
42         },
43         {
44           "value": "ФС-99-04-005763",
45           "type": "ru_license_number",
46           "label": "Ru License Number"
47         },
48         {
49           "value": "Л016-00110-77/00565584",
50           "type": "ru_license_number",
51           "label": "Ru License Number"
52         }
53       ],
54       "label": "ООО \"ЭРБЭ ЭЛЕКТРОМЕДИЦИН\"",
55       "metadata": {
56         "shipments": 6,
57         "hsCodes": [
58           {
59             "key": "854231",
60             "doc_count": 6,
61             "value": "Electronic integrated circuits; processors and controllers, whether or not combined with memories, converters, logic circuits, amplifiers, clock and timing circuits, or other circuits",
62             "value_simple": "Integrated Circuits"
63           }
64         ],
65         "latestShipmentDate": "2024-07-10"
66       },
67       "pep": false,
68       "psa_count": 1,
69       "related_entities_count": 195,
70       "relationship_count": {
71         "has_shareholder": 1,
72         "notify_party_of": 133,
73         "has_director": 1,
74         "receives_from": 1,
75         "has_legal_representative": 1
76       },
77       "risk": {
78         "imports_bis_high_priority_items": {
79           "value": 1,
80           "metadata": {
81             "origin_shipment_product": [
82               "853669"
83             ]
84           },
85           "level": "elevated"
86         },
87         "imports_bis_high_priority_items_critical_components": {
88           "value": 1,
89           "metadata": {
90             "origin_shipment_product": [
91               "854231"
92             ]
93           },
94           "level": "high"
95         }
96       },
97       "sanctioned": false,
98       "source_count": {
99         "a9a18eeb901e4376c912e95dc05ceb78": {
100           "count": 9,
101           "label": "Russia Federal Tax Registry"
102         },
103         "66dfefb726ae00fde8f09f34c5578d35": {
104           "count": 360,
105           "label": "Russia Imports & Exports (January 2023 - Present)"
106         },
107         "e61c3b3478534c110b46cd64c7746e82": {
108           "count": 2,
109           "label": "Russia Federal Tax Service Financial Statements"
110         },
111         "56bce0e008204712e302271ddd7b4fb1": {
112           "count": 1,
113           "label": "Russia Federal Tax Registry (2018)"
114         }
115       },
116       "trade_count": {
117         "sent": 0,
118         "received": 192
119       },
120       "type": "company",
121       "user_attribute_count": {},
122       "user_record_count": 0,
123       "user_related_entities_count": 0,
124       "user_relationship_count": {},
125       "attribute_counts": {
126         "name": 3,
127         "business_purpose": 10,
128         "identifier": 7,
129         "additional_information": 2,
130         "country": 2,
131         "shares": 1,
132         "status": 1,
133         "address": 4,
134         "financials": 3
135       },
136       "psa_id": "4398046624552",
137       "reference_id": "56bce0e008204712e302271ddd7b4fb1/5087746065578_7705856072_OOO-ERBE-ELEKTROMEDICIN.html/1552661755844:e39b6745ba02f2a46afdd7ffbd700920",
138       "registration_date": "Registered 2008-09-08",
139       "translated_label": "GESELLSCHAFT MIT BESCHRANKTER HAFTUNG \"ERBE ELEKTROMEDIZIN\"",
140       "user_attribute_counts": {}
141     }
142   ],
143   "limit": 1,
144   "next": true,
145   "offset": 0,
146   "size": {
147     "count": 3,
148     "qualifier": "eq"
149   }
150 }

Search for a buyer. 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 10000. Defaults to 100.

offsetintegerOptional

Number of results to skip before returning response. Defaults to 0.

Request

This endpoint expects an object.

qstringOptional

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.

filterobjectOptional

Filters to be applied to search query to limit the result-set.

facetsbooleanOptional

Whether or not to return search facets in results giving counts by field. Defaults to false.

Response

This endpoint returns an object.

datalist of objects

limitinteger

nextboolean

offsetinteger

sizeobject

Search Buyers

Headers

Query parameters

Request

Response

Errors