同事交来十个 Instagram 帖子链接,要你整理一组店铺陈列参考。你打开后续接口,却发现它需要媒体 ID,而手里只有链接中一段字母和数字。这一步要解决的是标识转换,不必重新搜索整个平台。
从链接里认出 shortcode
文档示例中,instagram.com/p/DRhvwVLAHAG/ 的 DRhvwVLAHAG 就是 shortcode。保留大小写,把这一段放进 shortcode 参数,别把末尾斜杠、问号后的追踪参数或作者名一起带入。先拿一个已知帖子尝试,确认整理方法后再处理同事给的其他链接。原始链接应留在表中,转换后的标识不能代替读者打开来源的入口。
为同一帖子保存两种标识
响应说明列出了 status、shortcode 和 media_id。检查转换状态,核对返回的 shortcode 与输入一致,再保存 media_id。建议表格按“原链接、输入短码、媒体 ID、转换状态、人工核对备注”排列。若一个链接被不同同事重复提交,按已核对的标识合并参考条目,同时保留他们各自关心的陈列细节。
下一步查什么,取决于你的资料需求
拿到媒体 ID 后,先查看目标接口到底接收哪种标识,再决定是否传入。不要把 media_id 填到要求 shortcode 或账号 ID 的位置。这次转换本身不提供陈列分析,也不代表已经取得图片或正文。要记录色彩搭配、货架高度或商品摆放,应打开帖子阅读,或使用相应详情能力后根据实际数据整理。
把转换失败与内容不可用分开
转换成功只能说明得到了对应标识,不能承诺后续内容始终可访问。遇到异常,先检查短码有没有被复制时截断,再保留返回状态供排查;不要凭空填一个媒体 ID 让流程继续。完成后,你应能从每一行回到原帖,并说明这条标识准备交给哪一个后续步骤。这样同事接手时不用再从链接猜一次。
完整地址与参数
GET https://api.trmesh.com/openapi/api/v1/instagram/v1/shortcode_to_media_id
| 参数 | 类型 | 必填 | 含义 |
|---|---|---|---|
shortcode |
string | 是 | 帖子Shortcode |
可以复制的 Python 请求
安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。
import os
import requests
# 使用自己的 TRMesh 开发者密钥;不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/instagram/v1/shortcode_to_media_id"
params = {
"shortcode": "DRhvwVLAHAG"
}
response = requests.get(
url, params=params, timeout=30,
headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload) # 先核对真实响应,再提取业务字段
调用接口会使用你的 TRMesh 账号额度,运行前请确认接口价格。

