服务介绍

船舶模糊查询服务，是使用关键字（mmsi、imo、船名、呼号等）作为查询条件，模糊查询出所有符合条件的船舶静态信息；当使用imo作为输入时，可以查询该imo编号下，曾经使用的所有mmsi记录；当使用船名作为查询输入时，可以查询该船名所有历史使用船舶的信息。

注：mmsi（Maritime Mobile Service Identity），中文称为水上移动业务标识码，是一种九位数字码，用于船舶无线电通信系统中，能够独特识别各类台站和成组呼叫台站。MMSI具有唯一性，每条船都有一个对应的MMSI码，通常被称为"一船一码"或"九位码"，同一条船舶mmsi编号有可能在售卖后变更，mmsi前三位代表国家和地区。

imo（International Maritime Organization），是国际海事组织为每一条船分配的唯一识别码，由七位数字组成，用于全球范围内对船舶身份、技术信息及安全记录的追踪与管理。

适用场景

船舶模糊查询服务，一般在系统或平台中做模糊查询匹配，查询出来的mmsi编号可以作为单船位置查询、船舶历史轨迹的输入参数，结合起来实现模糊查询并匹配船舶的实时位置、状态、历史行进轨迹等。如果您已经有明确的船舶mmsi记录清单，则无需使用此服务，可直接使用单船位置查询、多船位置查询等服务监控管理您的船队。

请求限制

此服务使用前需要在控制台创建您应用的key。船舶模糊查询不限制访问次数，只要开通权限后可调用多次，您当前使用服务的权限清单在控制台中可以查看。

在线调试

提供无开发经验的用户在线访问接口数据，了解服务获取样例。需要提前创建船讯网API key并具备权限，对应的API Key需要到https://api.shipxy.com/v3/console/overview 获取，参见 https://33iwh234s7.apifox.cn/8961339m0

请求地址

请求地址	请求方式	备注
https://api.shipxy.com/apicall/v3/SearchShip	Get	当使用船名或imo模糊匹配时，会返回多个结果，可以参考AIS最新上报的时间，来做区分。船舶在变更过船东或者在某些租赁环节会变更mmsi，旧的mmsi依旧会有记录，可根据实际场景进行筛选。

请求调用示例

https://api.shipxy.com/apicall/v3/SearchShip?key=1F6D701272402D1E7D8D316CCE519123&keywords=cosco&max=3

**注：**例子中的 1F6D701272402D1E7D8D316CCE519123 是船讯网的官方 key，已经绑定域名 api.shipxy.com，用户无权也无法使用该 key 获取数据，使用该 key 会返回 status 14 的状态码，提示来源域错误。用户如需试用服务，请在控制台创建自己的key。

返回响应

⚪0成功

application/json

成功返回船舶模糊查询结果

Bodyapplication/json

示例

"status": 0,
"msg": "",
"total": 2,
"data": [
    {
        "match_type": 5,
        "mmsi": 212759000,
        "imo": 9363132,
        "call_sign": "5BSD6",
        "ship_name": "IOLE R",
        "data_source": 0,
        "last_time": "2025-09-17 10:09:44",
        "last_time_utc": 1758074984
    },
    {
        "match_type": 5,
        "mmsi": 538008645,
        "imo": 9363132,
        "call_sign": "V7A2610",
        "ship_name": "IOLE R",
        "data_source": 0,
        "last_time": "2025-08-16 10:49:48",
        "last_time_utc": 1755312588
    }
]
}
}

1.2 船舶模糊查询

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

1.2 船舶模糊查询

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例