Home

Introduction

World Sea Ports API

version 1

The World Sea Ports API is designed to explore seaports worldwide. Connect to our comprehensive database of seaport locations and search insights by ID, Country, and Query. Ensure accurate mapping across global logistics points.

OpenAPI Specification

Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.

General information

World Sea Ports API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API endpoint#

1https://geocoding.searates.com

All endpoints are only accessible via HTTPS and are located at geocoding.searates.com

Get Port by ID

post/geo/world-sea-ports/lookup

Get World Sea Port by ID

Headers

Content-Typeapplication/json

Body Parameters
  • idREQUIREDstring

    Identifyer for city, builded like first letter 'T' + XXXXXXXXX, where X's is any letter or digit

    Match pattern:^[T][A-Za-z0-9]{9}$

Request sample
{
  "id": "T7ZOSA8Z2S"
}
Response example
OK
1{
2  "id": "T7ZOSA8Z2S",
3  "name": "Odesa",
4  "locode": "UAODS",
5  "iata": null,
6  "location": [
7    46.5,
8    30.730773
9  ],
10  "features": {
11    "is_airport": true,
12    "is_seaport": true,
13    "is_rail_terminal": true,
14    "is_road_terminal": true,
15    "is_icd": true,
16    "is_fixed_transport": false,
17    "is_riverport": false
18  },
19  "boundaries": {
20    "polylines": [
21      "BF2it7Fyzz7ItEwvMu5IvBqvB5pFy6E9wBh2C30F5oMwB"
22    ]
23  },
24  "entityType": "tradeport",
25  "country": {
26    "id": "UA",
27    "name": "Ukraine"
28  },
29  "admin": {
30    "id": "UA.51",
31    "name": "Odesa",
32    "location": null
33  },
34  "city": {
35    "id": "CGSDULWV3F",
36    "name": "Odesa",
37    "location": [
38      46.484302,
39      30.732288
40    ]
41  },
42  "teu": 1600000,
43  "statistics": {
44    "area": 32869623.263405
45  },
46  "properties": [
47    {
48      "id": 3325,
49      "name": "address",
50      "display_name": "address",
51      "value": "1, Customs Sg. <br>Odessa 65026 <br>Ukraine"
52    },
53    {
54      "id": 3326,
55      "name": "phone",
56      "display_name": "phone",
57      "value": "+38 (048) 729 35 00"
58    },
59    {
60      "id": 3327,
61      "name": "fax",
62      "display_name": "fax",
63      "value": "+38 (048) 729 36 27"
64    },
65    {
66      "id": 3328,
67      "name": "port_type",
68      "display_name": "port type",
69      "value": "Seaport"
70    },
71    {
72      "id": 3329,
73      "name": "port_size",
74      "display_name": "port size",
75      "value": "Medium"
76    },
77    {
78      "id": 3330,
79      "name": "port_authority",
80      "display_name": "port authority",
81      "value": "Ukrainian Sea Ports Authority"
82    },
83    {
84      "id": 3337,
85      "name": "harbor_size",
86      "display_name": "Harbor Size",
87      "value": "medium"
88    },
89    {
90      "id": 3338,
91      "name": "harbor_type",
92      "display_name": "Harbor Type",
93      "value": "coastal breakwater"
94    },
95    {
96      "id": 3339,
97      "name": "shelter",
98      "display_name": "Shelter",
99      "value": "good"
100    },
101    {
102      "id": 3341,
103      "name": "maximum_vessel_size",
104      "display_name": "Maximum Vessel Size",
105      "value": "over 500 feet in length"
106    },
107    {
108      "id": 3348,
109      "name": "channel",
110      "display_name": "Channel",
111      "value": "26 - 30 feet<br>7.1 - 9.1 meters"
112    },
113    {
114      "id": 3349,
115      "name": "anchorage",
116      "display_name": "Anchorage",
117      "value": "61 - 65 feet<br>18.6 - 19.8 meters"
118    },
119    {
120      "id": 3350,
121      "name": "cargo_pier",
122      "display_name": "Cargo Pier",
123      "value": "31 - 35 feet<br>9.4 - 10 meters"
124    },
125    {
126      "id": 3351,
127      "name": "oil_terminal",
128      "display_name": "Oil Terminal",
129      "value": "16 - 20 feet<br>4.9 - 6.1 meters"
130    },
131    {
132      "id": 3388,
133      "name": "ship_repairs",
134      "display_name": "Ship Repairs",
135      "value": "major"
136    },
137    {
138      "id": 3389,
139      "name": "drydock_size",
140      "display_name": "Drydock Size",
141      "value": "medium"
142    },
143    {
144      "id": 3390,
145      "name": "marine_railroad_size",
146      "display_name": "Marine Railroad Size",
147      "value": "small"
148    },
149    {
150      "id": 3333,
151      "name": "first_port_of_entry",
152      "display_name": "First Port of Entry",
153      "value": "true"
154    },
155    {
156      "id": 3335,
157      "name": "e_t_a_message_required",
158      "display_name": "ETA Message Required",
159      "value": "true"
160    },
161    {
162      "id": 3336,
163      "name": "medical_facilities",
164      "display_name": "Medical Facilities",
165      "value": "true"
166    },
167    {
168      "id": 3342,
169      "name": "good_holding_ground",
170      "display_name": "Good Holding Ground",
171      "value": "true"
172    },
173    {
174      "id": 3347,
175      "name": "overhead_limit",
176      "display_name": "Overhead Limit",
177      "value": "true"
178    },
179    {
180      "id": 3352,
181      "name": "compulsory",
182      "display_name": "Compulsory",
183      "value": "true"
184    },
185    {
186      "id": 3353,
187      "name": "advisable",
188      "display_name": "Advisable",
189      "value": "true"
190    },
191    {
192      "id": 3354,
193      "name": "available",
194      "display_name": "Available",
195      "value": "true"
196    },
197    {
198      "id": 3356,
199      "name": "assist",
200      "display_name": "Assist",
201      "value": "true"
202    },
203    {
204      "id": 3358,
205      "name": "pratique",
206      "display_name": "Pratique",
207      "value": "true"
208    },
209    {
210      "id": 3359,
211      "name": "deratt_cert",
212      "display_name": "Deratt Cert",
213      "value": "true"
214    },
215    {
216      "id": 3360,
217      "name": "telephone",
218      "display_name": "Telephone",
219      "value": "true"
220    },
221    {
222      "id": 3331,
223      "name": "river",
224      "display_name": "river",
225      "value": "false"
226    },
227    {
228      "id": 3334,
229      "name": "u_s_a_representative",
230      "display_name": "USA Representative",
231      "value": "false"
232    },
233    {
234      "id": 3343,
235      "name": "tide",
236      "display_name": "Tide",
237      "value": "false"
238    },
239    {
240      "id": 3344,
241      "name": "swell",
242      "display_name": "Swell",
243      "value": "false"
244    },
245    {
246      "id": 3357,
247      "name": "salvage",
248      "display_name": "Salvage",
249      "value": "false"
250    },
251    {
252      "id": 256679,
253      "name": "restriction_other",
254      "display_name": "Entrance Restriction - Other",
255      "value": "1"
256    },
257    {
258      "id": 256680,
259      "name": "mean_tide",
260      "display_name": "mean tide",
261      "value": "1"
262    },
263    {
264      "id": 256681,
265      "name": "maximum_vessel_beam",
266      "display_name": "maximum vessel beam",
267      "value": "0"
268    },
269    {
270      "id": 256682,
271      "name": "maximum_vessel_draft",
272      "display_name": "maximum vessel draft",
273      "value": "0"
274    },
275    {
276      "id": 256686,
277      "name": "quarantine_sanitation",
278      "display_name": "quarantine sanitation",
279      "value": "1"
280    },
281    {
282      "id": 256706,
283      "name": "entrance_width",
284      "display_name": "Entrance Width",
285      "value": "0"
286    },
287    {
288      "id": 256707,
289      "name": "lng_terminal_depth",
290      "display_name": "Liquified natural gas terminal depth",
291      "value": "0"
292    },
293    {
294      "id": 256708,
295      "name": "offshore_max_vessel_length",
296      "display_name": "offshore_max vessel length",
297      "value": "0"
298    },
299    {
300      "id": 256709,
301      "name": "offshore_vessel_beam",
302      "display_name": "offshore vessel beam",
303      "value": "0"
304    },
305    {
306      "id": 256710,
307      "name": "offshore_max_vessel_draft",
308      "display_name": "offshore_max vessel draft",
309      "value": "0"
310    },
311    {
312      "id": 326147,
313      "name": "is_dry",
314      "display_name": "is dry",
315      "value": "dry"
316    },
317    {
318      "id": 326148,
319      "name": "is_tanker",
320      "display_name": "is tanker",
321      "value": "tanker"
322    },
323    {
324      "id": 326149,
325      "name": "is_liner",
326      "display_name": "is liner",
327      "value": "liner"
328    },
329    {
330      "id": 326150,
331      "name": "is_specialized_cargo",
332      "display_name": "is specialized cargo",
333      "value": "snp"
334    },
335    {
336      "id": 326151,
337      "name": "is_offshore",
338      "display_name": "is offshore",
339      "value": "offshore"
340    },
341    {
342      "id": 326152,
343      "name": "is_trade",
344      "display_name": "is trade",
345      "value": "trade"
346    },
347    {
348      "id": 3362,
349      "name": "radio",
350      "display_name": "Radio",
351      "value": "true"
352    },
353    {
354      "id": 3363,
355      "name": "radio_tel",
356      "display_name": "Radio Tel",
357      "value": "true"
358    },
359    {
360      "id": 3364,
361      "name": "air",
362      "display_name": "Air",
363      "value": "true"
364    },
365    {
366      "id": 3365,
367      "name": "rail",
368      "display_name": "Rail",
369      "value": "true"
370    },
371    {
372      "id": 3366,
373      "name": "wharves",
374      "display_name": "Wharves",
375      "value": "true"
376    },
377    {
378      "id": 3367,
379      "name": "anchor",
380      "display_name": "Anchor",
381      "value": "true"
382    },
383    {
384      "id": 3370,
385      "name": "100+_ton_lifts",
386      "display_name": "100+ Ton Lifts",
387      "value": "true"
388    },
389    {
390      "id": 3372,
391      "name": "50-100_ton_lifts",
392      "display_name": "50-100 Ton Lifts",
393      "value": "true"
394    },
395    {
396      "id": 3373,
397      "name": "mobile_cranes",
398      "display_name": "Mobile Cranes",
399      "value": "true"
400    },
401    {
402      "id": 3374,
403      "name": "25-49_ton_lifts",
404      "display_name": "25-49 Ton Lifts",
405      "value": "true"
406    },
407    {
408      "id": 3375,
409      "name": "floating_cranes",
410      "display_name": "Floating Cranes",
411      "value": "true"
412    },
413    {
414      "id": 3376,
415      "name": "0-24_ton_lifts",
416      "display_name": "0-24 Ton Lifts",
417      "value": "true"
418    },
419    {
420      "id": 3382,
421      "name": "provisions",
422      "display_name": "Provisions",
423      "value": "true"
424    },
425    {
426      "id": 3383,
427      "name": "water",
428      "display_name": "Water",
429      "value": "true"
430    },
431    {
432      "id": 3384,
433      "name": "fuel_oil",
434      "display_name": "Fuel Oil",
435      "value": "true"
436    },
437    {
438      "id": 3385,
439      "name": "diesel_oil",
440      "display_name": "Diesel Oil",
441      "value": "true"
442    },
443    {
444      "id": 3386,
445      "name": "deck",
446      "display_name": "Deck",
447      "value": "true"
448    },
449    {
450      "id": 3387,
451      "name": "engine",
452      "display_name": "Engine",
453      "value": "true"
454    },
455    {
456      "id": 3391,
457      "name": "garbage_disposal",
458      "display_name": "Garbage Disposal",
459      "value": "true"
460    },
461    {
462      "id": 3392,
463      "name": "dirty_ballast",
464      "display_name": "Dirty Ballast",
465      "value": "true"
466    }
467  ]
468}

Ports by country

post/geo/world-sea-ports/list-by-country

Get ports list by selected country

Headers

Content-Typeapplication/json

Body Parameters
  • country_codeREQUIREDstring

    Match pattern:^[A-Z]{2}

  • is_riverOptionalboolean
Request sample
{
  "country_code": "LT",
  "is_river": false
}
Response example
OK
1[
2  {
3    "id": "THFZ3ZZPAC",
4    "name": "Klaipeda",
5    "location": [
6      55.703557,
7      21.126023
8    ],
9    "locode": "LTKLJ",
10    "iata": null,
11    "features": {
12      "is_airport": true,
13      "is_seaport": true,
14      "is_rail_terminal": true,
15      "is_road_terminal": false,
16      "is_icd": false,
17      "is_fixed_transport": false,
18      "is_river_port": false
19    }
20  }
21]

Find Port by name

post/geo/world-sea-ports/find

Find Port by name

Headers

Content-Typeapplication/json

Body Parameters
  • queryREQUIREDstring
Request sample
{
  "query": "Odesa"
}
Response example
OK
1{
2  "id": "T7ZOSA8Z2S",
3  "name": "Odesa",
4  "location": [
5    46.5,
6    30.730773
7  ],
8  "locode": "UAODS",
9  "iata": null,
10  "features": {
11    "is_airport": false,
12    "is_seaport": true,
13    "is_rail_terminal": true,
14    "is_road_terminal": true,
15    "is_icd": true,
16    "is_fixed_transport": false,
17    "is_river_port": false
18  }
19}