The World Sea Ports API is designed to explore seaports worldwide. Ensure accurate mapping across global logistics points. Search by flexible location names and Filter by Cities, Admin Regions, Countries, and World Regions with multi-language support.
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.
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.
1https://geocoding.searates.com
All endpoints are only accessible via HTTPS and are located at geocoding.searates.com
post/geo/world-sea-ports/lookupGet World Sea Port by ID
api_keyExample: ?api_key=123
Content-Typeapplication/json
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}$
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}post/geo/world-sea-ports/list-by-countryGet ports list by selected country
api_keyExample: ?api_key=123
Content-Typeapplication/json
Match pattern:^[A-Z]{2}
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]post/geo/world-sea-ports/findFind Port by name
api_keyExample: ?api_key=123
Content-Typeapplication/json
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}