Explorador de Logística

This document describes the Logistics Explorer API web service. Our API documentation allows to calculate FCL, FTL rates and port fees.

URL https://sirius.searates.com/port/api-fcl?parameters
HTTP Method GET
Output Format JSON

Input Parameters

Parameter name Required Type Description
apiKey yes string API key: hexadecimal number
lat_from yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of loading.
lng_from yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of loading.
lat_to yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of discharge.
lng_to yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of discharge.
route_info no bool Show ports details and sea route. The available values for this parameter are: true | false
Default value: false

Example URL

https://sirius.searates.com/port/api-fcl?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=-19.85&lng_to=-56.8843

The above query returns the following result:

{
   "rates":{
      "fcl":[
         {
            "id":448479,
            "20st":"1500",
            "40st":"2600",
            "40hq":"2600",
            "currency":"USD",
            "sealine":"MAERSK",
            "thc_exp":true,
            "thc_imp":false,
            "fee_exp":false,
            "fee_imp":false,
            "valid_date_from":"2016-10-23",
            "valid_date_to":"2018-11-02",
            "transit_time":"26 days 11 hours"
         },
         {
            "id":24208,
            "20st":"1550",
            "40st":"2800",
            "40hq":"2800",
            "currency":"USD",
            "sealine":null,
            "thc_exp":false,
            "thc_imp":false,
            "fee_exp":false,
            "fee_imp":false,
            "valid_date_from":"2017-04-01",
            "valid_date_to":"2018-11-02",
            "transit_time":"26 days 11 hours"
         }
      ],
      "road_from":{
         "rate":1579.5634,
         "currency":"USD"
      },
      "road_to":{
         "rate":975.3110992,
         "currency":"USD"
      },
      "port_fees_from":[
         [
            "ADE",
            "Agency Documentation Fee Exports",
            30,
            true
         ],
         [
            "ERI",
            "Ecological and Radiological Service",
            15,
            false
         ],
         [
            "EXP",
            "Export Service",
            120,
            false
         ],
         [
            "FFC",
            "Forwarder Commission - Origin",
            35,
            false
         ],
         [
            "HDL",
            "Lift On Lift Off Service",
            36,
            false
         ],
         [
            "IHW",
            "Inland Haulage Container Weighing",
            10,
            false
         ],
         [
            "ODF",
            "Documentation Fee - Origin",
            25,
            true
         ],
         [
            "PAE",
            "Port Additionals \/ Port Dues - Export",
            27,
            false
         ],
         [
            "ULE",
            "Agency Logistics fee export",
            26,
            false
         ],
         [
            "OTHC",
            "Original Terminal Handling Charge",
            330,
            false
         ]
      ],
      "port_fees_to":[
         [
            "ADI",
            "Agency Documentation Fee imports",
            30,
            true
         ],
         [
            "ERI",
            "Ecological and Radiological Service",
            15,
            false
         ],
         [
            "IHW",
            "Inland Haulage Container Weighing",
            10,
            false
         ],
         [
            "IMP",
            "Import Service",
            25,
            false
         ],
         [
            "PAI",
            "Port Additionals \/ Port Dues - Import",
            20,
            false
         ],
         [
            "ULI",
            "Agency Logistic Fee Import",
            25,
            false
         ],
         [
            "DTHC",
            "Destination Terminal Handling Charge",
            200,
            false
         ]
      ]
   }
}

This document describes the Logistics Explorer API web service. Our API documentation allows to calculate LCL, LTL rates and port fees.

URL https://sirius.searates.com/port/api-lcl?parameters
HTTP Method GET
Output Format JSON

Input Parameters

Parameter name Required Type Description
apiKey yes string API key: hexadecimal number
lat_from yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of loading.
lng_from yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of loading.
lat_to yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of discharge.
lng_to yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of discharge.
weight yes integer Weight of cargo in kg
volume yes integer Volume of cargo in CBM

Example URL

https://sirius.searates.com/port/api-lcl?apiKey=XXXXXXXXXXX&lat_from=24.8607343&lng_from=67.00113639999995&lat_to=46.482526&lng_to=30.723309500000028&weight=1000&volume=1

The above query returns the following result:

{
  "rates": {
    "lcl": {
      "rate": "135",
      "currency": "USD",
      "id": 43989,
      "valid_date_to": "2018-12-30"
    },
    "road_from": {
      "rate": 400,
      "currency": "USD"
    },
    "port_fees_from": [
      [
        "ADE",
        "Agency Documentation Fee Exports",
        30,
        true
      ],
      [
        "OTHC",
        "Original Terminal Handling Charge",
        35000,
        true
      ],
      [
        "PAE",
        "Port Additionals / Port Dues - Export",
        25000,
        true
      ]
    ],
    "port_fees_to": [
      [
        "ADI",
        "Agency Documentation Fee imports",
        30,
        true
      ],
      [
        "DTHC",
        "Destination Terminal Handling Charge",
        35000,
        true
      ],
      [
        "PAI",
        "Port Additionals / Port Dues - Import",
        25000,
        true
      ]
    ],
    "road_to": {
      "rate": 75,
      "currency": "USD"
    }
  }
}
URL https://sirius.searates.com/port/api-path?parameters
HTTP Method GET
Output Format JSON

Input Parameters

Parameter name Required Type Description
apiKey yes string API key: hexadecimal number
lat_from yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of loading.
lng_from yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of loading.
lat_to yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of discharge.
lng_to yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of discharge.

Example URL

https://sirius.searates.com/port/api-path?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=-19.85&lng_to=-56.8843

The above query returns the following result:

{
   "route":{
      "dist":"12419.73",
      "path":"{30.730773925781,46.5,30.758972167969,46.511625395438,30.758972167969,46.511625395438,30.819396972656,46.489883541007,30.824680505371,46.436555936107,30.725116906737,46.325475946741,30.627136230469,46.031140184419,29.170074462891,41.24693139645,29.114791375445,41.207973198788,29.083213806152,41.179974225999,29.063816070557,41.159340583766,29.065532684326,41.141140050304,29.080123901367,41.123971420422,29.065189361572,41.107822223054,29.060039520264,41.098017190186,29.061069488525,41.083166269863,29.058236792072,41.078189908522,29.051284790039,41.075542531793,29.046478271484,41.055129637182,29.03720659179,41.045562554137,28.9956665039062,41.0279874522154,28.990516662598,41.005552688238,28.97970199585,40.997131818177,28.8253784179687,40.9355032692388,27.755584716797,40.682736808636,27.6058959960937,40.6782481004625,27.510417027466,40.658097138288,27.038726806641,40.511938422534,26.671497438554,40.387408651504,26.646613683123,40.351561119488,26.444778442383,40.215661531379,26.402200445953,40.205212692524,26.385725911029,40.190560952963,26.389846801758,40.153400004175,26.382293701172,40.120911946181,26.187286376953,40.020219765046,26.0293579101562,39.9425078669945,25.845336914062,39.769806795985,25.751953125,39.1987067162206,24.724731445312,38.089639545062,24.617614746094,37.926483748102,24.1067504882812,37.6284683104105,23.238830566406,36.412332468029,23.047106120104,36.392147728936,22.813838339935,36.43459603504,22.632945446366,36.360312733004,22.403869628906,36.360454655144,15.049896240234,36.601196658744,14.78759765625,36.658504568975,14.694900512695,36.685490639009,14.444274902344,36.736683064731,11.041259765625,37.212636777713,9.8794555664062,37.473139366222,9.7942663382033,37.470283298339,6.46545410156247,37.1513656074632,5.0015258789062,37.031211189637,3.9454650878906,36.981797063198,3.7566328517775,36.959304077708,2.9592386402107,36.896153771838,0.917358398437467,36.5809766665745,0.1043701171875,36.221381657439,-0.43121337890625,35.991340960635,-1.1041259765625,35.815250169427,-2.9406722739757,35.502687650191,-5.2823638916016,35.944781116016,-5.5055236816406,35.939203883606,-5.73486328125,35.895181682182,-6.0562133789062,35.826408901004,-8.5171508789062,33.351877730188,-8.7451171875,33.152326302774,-9.2999267578125,32.653250879969,-9.3521118164062,32.500496489245,-9.42626953125,32.277844514983,-13.317916482157,27.986870923857,-14.466664246448,26.486352757578,-16.111450195313,24.024745076322,-17.369384765625,21.48245191885,-34.702483585103,-8.4600260964326,-39.088855814875,-19.437603281259,-40.370243255206,-22.453189631559,-42.046051025391,-23.101207389715,-44.478149414062,-23.812789391972,-45.259643588603,-24.139333404224,-48.290405273438,-25.624192441212,-48.33366394043,-25.613047870816,-48.345336914062,-25.546778150624,-48.371429443359,-25.529430487502,-48.398895263672,-25.53314805514,-48.414688110352,-25.542441470125,-48.444900512695,-25.538104632759,-48.472366333008,-25.530669689516,-48.472366333008,-25.530669689516,-48.507385253906,-25.554053711007}",
      "st":1,
      "port_name_from":"Odessa",
      "port_country_from":"UA",
      "port_name_to":"Paranagua",
      "port_country_to":"BR",
      "locode_from":"UAODS",
      "locode_to":"BRPNG"
   }
}

This document describes the Logistics Explorer API web service. Our API documentation allows to calculate Air rates and port fees.

URL https://sirius.searates.com/port/api-air?parameters
HTTP Method GET
Output Format JSON

Input Parameters

Parameter name Required Type Description
apiKey yes string API key: hexadecimal number
lat_from yes float number The latitude value specifying the location for which you wish to obtain the closest air port of loading.
lng_from yes float number The longitude value specifying the location for which you wish to obtain the closest air port of loading.
lat_to yes float number The latitude value specifying the location for which you wish to obtain the closest air port of discharge.
lng_to yes float number The longitude value specifying the location for which you wish to obtain the closest air port of discharge.
weight yes float number Weight of cargo in tons

Example URL

https://sirius.searates.com/port/api-air?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=40.7127753&lng_to=-74.0059728&weight=0.3

The above query returns the following result:

{
   "rates":{
      "road_from":{
         "name":"Boryspil Intl",
         "lat":50.344999999999998863131622783839702606201171875,
         "lng":30.8947220000000015716068446636199951171875,
         "country":"UA",
         "rate":29,
         "profile":472173,
         "company_name":"SeaRates LTD",
         "path":"Kyiv - Odesa"
      },
      "road_to":{
         "name":"Wall Street Heliport",
         "lat":40.70121400000000022600943339057266712188720703125,
         "lng":-74.00902800000000070212990976870059967041015625,
         "country":"UA",
         "rate":13,
         "profile":472173,
         "company_name":"SeaRates LTD",
         "path":"Florida - Texas"
      },
      "air":[
         {
            "export":[
               [
                  "EXP",
                  "Export Service",
                  90,
                  true,
                  471971,
                  "SeaRates LTD",
                  "MT"
               ],
               [
                  "ODF",
                  "Documentation Fee - Origin",
                  80,
                  true,
                  471971,
                  "SeaRates LTD",
                  "MT"
               ]
            ],
            "import":[
               [
                  "DDF",
                  "Documentation Fee - Destination",
                  80,
                  true,
                  1,
                  "SeaRates LTD",
                  "MT"
               ],
               [
                  "IMP",
                  "Import Service",
                  90,
                  true,
                  1,
                  "SeaRates LTD",
                  "MT"
               ]
            ],
            "id":285529,
            "profile":1,
            "user":1,
            "profile_chat":1,
            "company_name":"SeaRates LTD",
            "country":"MT",
            "indicative":null,
            "line_id":0,
            "al_name":"Indicative",
            "term":"",
            "comment":null,
            "fav":false,
            "transit_time":null,
            "valid_date_to":"2018-12-07",
            "rate":1110
         }
      ]
   }
}

This document describes the Logistics Explorer API web service. Our API documentation allows to calculate Rail rates and port fees.

URL https://sirius.searates.com/port/api-rail?parameters
HTTP Method GET
Output Format JSON

Input Parameters

Parameter name Required Type Description
apiKey yes string API key: hexadecimal number
lat_from yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of loading.
lng_from yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of loading.
lat_to yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of discharge.
lng_to yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of discharge.

Example URL

https://sirius.searates.com/port/api-rail?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=40.7127753&lng_to=-74.0059728

The above query returns the following result:

Where 20st - 20' standard container, 40st - 40' standard container, FW - Freight wagon, TW - Tank wagon, CW - Covered wagon, HW - Hopper wagon

{
  "rates": [
    {
      "profile": 387629,
      "currency": "USD",
      "rate": 402.08,
      "type": "20st",
      "distance": 679.696
    },
    {
      "profile": 387629,
      "currency": "USD",
      "rate": 511.74,
      "type": "40st",
      "distance": 679.696
    },
    {
      "profile": 472173,
      "currency": "USD",
      "rate": 1676.26,
      "type": "FW",
      "distance": 679.696
    },
    {
      "profile": 429126,
      "currency": "USD",
      "rate": 1969.47,
      "type": "TW",
      "distance": 679.696
    },
    {
      "profile": 251579,
      "currency": "USD",
      "rate": 1117.61,
      "type": "CW",
      "distance": 679.696
    },
    {
      "profile": 472173,
      "currency": "USD",
      "rate": 1520.65,
      "type": "HW",
      "distance": 679.696
    }
  ]
}

This document describes the Logistics Explorer API web service. Our API documentation allows to calculate Road rates.

URL https://sirius.searates.com/port/api-road?parameters
HTTP Method GET
Output Format JSON

Input Parameters

Parameter name Required Type Description
apiKey yes string API key: hexadecimal number
type no string Type of shipment. The available values for this parameter are: LTL | FTL | CONTAINER
Default value: CONTAINER
container no string Container type. The available values for this parameter are: 20st | 40st | 40hq | 20ref | 40ref
Default value: 20st
lat_from yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of loading.
lng_from yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of loading.
lat_to yes float number The latitude value specifying the location for which you wish to obtain the closest sea port of discharge.
lng_to yes float number The longitude value specifying the location for which you wish to obtain the closest sea port of discharge.
weight yes integer Weight of cargo in kg
volume yes integer Volume of cargo in CBM

Example URL

https://sirius.searates.com/port/api-road?apiKey=XXXXXXXXXXX&lat_from=46.482526&lng_from=30.7233095&lat_to=50.4501&lng_to=30.5234&weight=0.3&volume=1&type=LTL
https://sirius.searates.com/port/api-road?apiKey=XXXXXXXXXXX&lat_from=46.482526&lng_from=30.7233095&lat_to=50.4501&lng_to=30.52348&weight=0.3&volume=70&type=FTL
https://sirius.searates.com/port/api-road?apiKey=XXXXXXXXXXX&lat_from=46.482526&lng_from=30.7233095&lat_to=50.4501&lng_to=30.5234&weight=0.3&volume=1&type=CONTAINER&container=40hq

The above query returns the following result:

{
  "rates": [
    {
      "m3": 60,
      "rate": 440,
      "currency": "USD",
      "type": "FTL",
      "profile_chat": 492155,
      "company_name": "SeaRates LTD"
    },
    {
      "m3": 65,
      "rate": 487.5,
      "currency": "USD",
      "type": "FTL",
      "profile_chat": 492155,
      "company_name": "SeaRates LTD"
    },
    {
      "m3": 70,
      "rate": 535,
      "currency": "USD",
      "type": "FTL",
      "profile_chat": 492155,
      "company_name": "SeaRates LTD"
    },
    {
      "m3": 75,
      "rate": 582.5,
      "currency": "USD",
      "type": "FTL",
      "profile_chat": 492155,
      "company_name": "SeaRates LTD"
    },
    {
      "m3": 80,
      "rate": 630,
      "currency": "USD",
      "type": "FTL",
      "profile_chat": 492155,
      "company_name": "SeaRates LTD"
    }
  ]
}