给一个 Reddit 搜索关键词、采集数量、排序方式和时间范围,返回匹配帖子的标题、作者、链接与时间信息
概览
Instagram 关键词搜索(登录方案)面向需要扩大 Instagram 站内公开内容覆盖面的场景。输入品牌、产品或话题词后,它会把匹配到的公开帖子整理成一条条记录,保留账号、正文、媒体、互动计数和发布时间,方便建立可筛选的监测底表。
与通过 Google 获取 Instagram 相关网页结果的搜索方式相比,这份数据直接面向 Instagram 站内搜索结果,能够覆盖更多站内公开内容。它适合沉淀品牌提及、活动传播和竞品讨论等内容线索,减少人工翻看搜索结果的工作量。
数据说明
数据来自 Instagram 站内关键词搜索中采集时可见的公开帖子,内容编号作为结果记录标识保留。采集项和命中关键词在结果里可能取值相同,但代表不同原始字段,因此分别保留。点赞数、评论数、播放数和观看数是文本形态的计数。发布时间是结果里给出的时间,未标注时区。话题标签、提及账号、媒体明细、赞助信息和标记用户以原文文本给出,可能是列表的文本形式。不覆盖私密账号、已删除或采集时不可见的内容。
结果长什么样
每条记录代表一条命中该关键词的 Instagram 站内公开帖子:
| 内容编号 | 账号名称 | 媒体类型 | 点赞数 | 发布时间 | 是否认证 |
|---|---|---|---|---|---|
| 1813180601759799370 | fiu_caps | Video | 89 | 2018-06-30T22:19:09 | 否 |
| 2996163004787545488 | footballedtizz | Sidecar | 4547 | 2022-12-19T03:08:04 | 否 |
另有内容正文、头像链接、主页链接、话题标签和是否无数据等字段。
应用场景
- 用命中关键词和内容正文追踪品牌或活动在 Instagram 站内被怎样讨论。
- 用账号名称、是否认证和主页链接识别主要传播账号。
- 用点赞数、评论数和发布时间比较哪些帖子更能带动互动。
适用边界
通过登录方案采集 Instagram 站内公开搜索结果;每次任务仅支持 1 个关键词,期望采集 1 至 200 条;每页固定返回 20 条,最多拉取 10 页(200 条);不等同于通过 Google 获取的 Instagram 相关网页搜索结果。
- 适合用于
- 需要通过登录方案获取更多 Instagram 站内公开搜索结果时
- 需要把公开帖子的账号、正文、媒体和互动数据整理成监测底表时
- 不要用于
- 只需要 Google 或其他搜索引擎中的 Instagram 相关网页结果时——应使用网页搜索类 App
- 需要私密账号、已删除或登录后仍不可见的内容时——本 App 仅覆盖采集时可见的站内内容
- 需要单条帖子的完整评论列表或私信时——本 App 只返回搜索结果中的帖子与互动计数
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回空结果时,先更换或缩短搜索关键词后重新提交
- 2是否无数据为是表示该关键词没有采集到内容,可核对关键词后重试
- 3限流、服务暂不可用或请求超时可稍后原样重试
- 4任务提交结果不明时不要连续重复提交,避免产生重复任务
- 5任务部分成功时保留已返回记录;失败或过期后可原样重新提交
- 6鉴权失败需先检查执行环境中的凭证配置
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 搜索关键词
keyword必填string要在 Instagram 搜索的品牌、活动或话题,一次任务只支持一个关键词,长度为 1–512 个字符示例world cup - 期望采集数量
crawl_num必填integer期望采集的公开帖子数量,范围为 1–200;实际返回可能向上取整,数量越大任务耗时越高范围1–200示例1
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 头像链接
accountAvatarUrlstring账号头像图片链接示例https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/92844867_702240107251390_3554936283346239488_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=108&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=EAIXUtQf3HgQ7kNvwEf2nPZ&_nc_oc=Adoxx2pB8f2qxD7U3jfpPLDUpJShDPqIsIkrmJkbVr4azNOR7ZjpGrn68dX3uQ4S-yM&_nc_zt=24&_nc_ht=scontent-ord5-1.cdninstagram.com&_nc_ss=702a8&oh=00_AQI0HiJ8jO-6dvWXI_ficm3jL3455lB4ezf8cNV4mL-sLA&oe=6AA6D25E - 粉丝数
accountFansCountstring账号粉丝数量的原文,未返回时为空 - 账号编号
accountIdstring发帖账号的 Instagram 编号示例226947216 - 账号名称
accountNamestring发帖账号的用户名示例fiu_caps
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"accountAvatarUrl": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/92844867_702240107251390_3554936283346239488_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=108&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=EAIXUtQf3HgQ7kNvwEf2nPZ&_nc_oc=Adoxx2pB8f2qxD7U3jfpPLDUpJShDPqIsIkrmJkbVr4azNOR7ZjpGrn68dX3uQ4S-yM&_nc_zt=24&_nc_ht=scontent-ord5-1.cdninstagram.com&_nc_ss=702a8&oh=00_AQI0HiJ8jO-6dvWXI_ficm3jL3455lB4ezf8cNV4mL-sLA&oe=6AA6D25E",
"accountFansCount": "<accountFansCount>",
"accountId": "226947216",
"accountName": "fiu_caps",
"alt": "<alt>",
"captionIsEdited": false,
"coCreatorInfo": "<coCreatorInfo>",
"commentCount": "7",
"contentId": "1813180601759799370",
"contentShortcode": "BkptiaRhZhK",
"contentText": "When you’re watching The World Cup and the stress hits you ⚽️\nCAPS can help you reach your goals to conquer stress! Schedule an appointment or call us 24/7 on our hotline at 305-348-2277!\nIs your team still in The World Cup? .\n🇫🇷🇦🇷🇺🇾🇵🇹🇪🇸🇷🇺🇭🇷🇩🇰🇧🇷🇲🇽🇧🇪🇯🇵🇸🇪🇨🇭🇨🇴🏴\n.\n.\n.\n.\n#CAPS #FIU #fiucaps #fiuvep #kiwithealien #fiufreshman #fiutransfer #fiu22 #FIU21 #fiu20 #fiu19 #fiu20 #fiu18 #theworldcup #FIUPanthers #worldcup #soccer #roundof16",
"contentUrl": "https://www.instagram.com/p/BkptiaRhZhK",
"displayUrl": "https://scontent-ord5-1.cdninstagram.com/v/t51.71878-15/530668199_1696410501013417_545743792716064539_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&ig_cache_key=MTgxMzE4MDYwMTc1OTc5OTM3MA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNzIwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=YG2lFIN6-X8Q7kNvwFDJxDb&_nc_oc=Adoc9iRC1JZAD3h339c4h1hTLH1sRufPoWgxRa1pOxaaOpgyPrgLQNOnZJIBxmCN0eM&_nc_zt=23&_nc_ht=scontent-ord5-1.cdninstagram.com&_nc_gid=6aVmLVWtetiB7jG3rUNLwg&_nc_ss=70aaf&oh=00_AQJRKR1K4wSRdjSB5GKrR7Yi7M8DlQR1HEeUA12mUfGZzg&oe=6AA6EAD0",
"fullName": "FIU CAPS",
"hashtags": "[\"CAPS\", \"FIU\", \"fiucaps\", \"fiuvep\", \"kiwithealien\", \"fiufreshman\", \"fiutransfer\", \"fiu22\", \"FIU21\", \"fiu20\", \"fiu19\", \"fiu18\", \"theworldcup\", \"FIUPanthers\", \"worldcup\", \"soccer\", \"roundof16\"]",
"inputUrl": "<inputUrl>",
"isAd": false,
"isCommentsDisabled": "<isCommentsDisabled>",
"isPinned": false,
"isVerified": false,
"keyword": "World Cup",
"keywordType": "keyword",
"likeCount": "89",
"likesHidden": false,
"locationId": "<locationId>",
"locationLatitude": 0,
"locationLongitude": 0,
"locationName": "<locationName>",
"mediaCount": 1,
"mediaItems": "[{\"alt\": null, \"hasAudio\": true, \"height\": 640, \"index\": 1, \"mediaType\": \"Video\", \"noteId\": \"1813180601759799370\", \"shortcode\": \"BkptiaRhZhK\", \"url\": \"https://scontent-ord5-2.cdninstagram.com/o1/v/t16/f2/m84/AQOvWGj6sgbLlBHMS4dRhgkXrxTOTpBkzDdQiquTguuLQ0a7JzWwPYSQIaOpCRqERLNcIi5KQrX7rbFNmIyqTJeT1hVlOwxb7rhObao.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=WN7a1wxfA4UQ7kNvwGI3GgU&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uRkVFRC5DMy42NDAuZGFzaF9iYXNlbGluZV8xX3YxIiwieHB2X2Fzc2V0X2lkIjoxMjczNDkzODI5OTcxNzU1LCJhc3NldF9hZ2VfZGF5cyI6MjgyOCwidmlfdXNlY2FzZV9pZCI6MTAxNDYsImR1cmF0aW9uX3MiOjEwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=21bc637819b2559e&_nc_vs=HBksFQIYTGlnX2JhY2tmaWxsX3RpbWVsaW5lX3ZvZC9GNTQzQTk0QkUzQzcxNjk1OEY0ODYzRUYzQzE2OTM4MV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HQUR1clJiQ1NiMzEzRElDQU0xZXBaMFNqZ1ZQYnBrd0FBQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAm1rzftYyPwwQVAigCQzMsF0AkAAAAAAAAGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHXqB2XEngEA&_nc_gid=6aVmLVWtetiB7jG3rUNLwg&_nc_ss=70aaf&_nc_zt=28&oh=00_AQLdV1pLvHkVf_T0BzCpzRMJFOu3KM6vaTfFtdxPmX-xqw&oe=6AA2F04E\", \"videoDuration\": 10.1, \"width\": 640}]",
"mediaType": "Video",
"mentions": "[]",
"musicInfo": "<musicInfo>",
"paidPartnership": false,
"playCount": "<playCount>",
"profileUrl": "https://www.instagram.com/fiu_caps/",
"publishContentCount": "<publishContentCount>",
"publishTime": "2018-06-30T22:19:09",
"sponsorInfo": "<sponsorInfo>",
"taggedUsers": "<taggedUsers>",
"viewCount": "<viewCount>",
"taskItem": "World Cup",
"noData": false
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。每 20 条为一个计费单位,不足 20 条按 20 条计。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。