For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LearnGraph LoginRequest a Demo
HomeAPIBulk DataSayari LibraryChange Log
  • Key Concepts
    • Introduction
    • Endpoint Overview
    • Authentication
    • Requests
    • Pagination
    • Response Status Codes
    • Data Types
    • Rate Limits
  • API Clients
    • Overview
    • Open API
    • Postman
    • Go
    • Python
    • Node
  • API Reference
      • POSTSearch Shipments
      • POSTSearch Suppliers
      • POSTSearch Buyers
  • Guides
    • Getting Started
    • Understanding Project Entity
    • Risk Factors
    • Entity Search
    • Advanced Entity Search
    • Resolution
    • Trade Search - Shipments
    • Trade Search - Suppliers & Buyers
    • v0 Migration
  • Implementation Patterns
    • Project Entity Supply Chain
  • Use Cases
    • Entity Screening & Verification
    • Investigations
LogoLogo
LearnGraph LoginRequest a Demo
API ReferenceTrade

Search Buyers

GA
POST
/v1/trade/search/buyers
POST
/v1/trade/search/buyers
$curl -X POST "https://api.sayari.com/v1/trade/search/buyers?limit=1" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "filter": {
>    "departure_country": [
>      "DEU"
>    ],
>    "arrival_country": [
>      "RUS"
>    ],
>    "hs_code": [
>      "854231"
>    ],
>    "arrival_date": "2024-01|2024-10"
>  }
>}'
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.
Was this page helpful?
Previous

Get Entity

Next
Built with

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Query parameters

limitintegerOptional
A limit on the number of objects to be returned with a range between 1 and 3000. 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

Errors

400
Bad Request
401
Unauthorized
405
Method Not Allowed
429
Rate Limit Exceeded
500
Internal Server Error