解决Bing新闻搜索API中originalImg参数不生效的问题-js教程-PHP中文网

解决Bing新闻搜索API中originalImg参数不生效的问题

霞舞

发布： 2025-09-27 14:05:29

原创

862人浏览过

解决Bing新闻搜索API中originalImg参数不生效的问题

本文旨在解析Bing新闻搜索API中originalImg参数的使用限制，指出其仅适用于/news/search端点，而非/news端点。通过对比错误用法和正确用法，帮助开发者理解如何有效获取新闻条目的原始图片URL，避免仅获取缩略图的问题，从而优化API调用策略。

在使用bing新闻搜索api时，开发者常希望获取新闻条目的原始图片，而非仅限于缩略图。为此，api提供了originalimg参数。然而，许多开发者在使用此参数时发现其并未按预期工作，导致返回结果中图片信息仅包含缩略图url，而缺少原始图片url。本文将深入探讨这一问题，并提供正确的解决方案。

问题描述：originalImg参数未生效

当开发者尝试通过Bing新闻搜索API获取新闻图片，并在请求中设置originalImg=true时，如果使用了/news端点，API的响应中通常只包含图片的缩略图信息，例如thumbnail.contentUrl，而缺少直接指向原始图片尺寸的contentUrl字段。

以下是一个典型的错误使用示例及其对应的响应结构：

错误用法示例代码：

const url = 'https://bing-news-search1.p.rapidapi.com/news?&originalImg=true&category=india&cc=in&safeSearch=Off&textFormat=Raw';
const options = {
    method: 'GET',
    headers: {
        'X-BingApis-SDK': 'true',
        'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', // 请替换为您的RapidAPI密钥
        'X-RapidAPI-Host': 'bing-news-search1.p.rapidapi.com'
    }
};

fetch(url, options)
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error(error));

登录后复制

上述请求的典型响应片段（仅包含缩略图）：

{
    "url": "https://www.msn.com/en-in/news/world/...",
    "image": {
        "_type": "ImageObject",
        "thumbnail": {
            "_type": "ImageObject",
            "contentUrl": "https://www.bing.com/th?id=OVFT._MJPdPJ958_nyj_Ker8qOy&pid=News",
            "width": 1280,
            "height": 720,
            "isLicensed": true
        }
    }
}

登录后复制

从上述响应可以看出，image对象中只有thumbnail字段提供了图片URL，且该URL指向的是Bing处理过的缩略图，而非原始尺寸图片。开发者期望的是在image对象下直接获得一个contentUrl字段，指向原始图片，类似如下结构：

{
    "image": {
        "_type": "ImageObject",
        "contentUrl": "https://s.yimg.com/ny/api/res/1.2/...", // 期望的原始图片URL
        "thumbnail": {
            "_type": "ImageObject",
            "contentUrl": "https://www.bing.com/th?id=OVFT.1Wypj4IiKxycYuiB2Q81GC&pid=News",
            "width": 700,
            "height": 350
        }
    }
}

登录后复制

根本原因：originalImg参数的端点限制

根据Bing新闻搜索API v7的官方文档说明，originalImg参数并非对所有新闻相关的API端点都有效。它明确指出：

"Use this parameter only with the News Search API. Do not specify this parameter when calling the Web Search API. Trending Topics ignores this parameter."

这意味着originalImg参数仅适用于/news/search端点，而当使用/news（获取热门新闻或特定类别新闻）或Trending Topics等其他端点时，该参数会被忽略。上述问题中，开发者使用了/news端点，因此originalImg=true的设置未能生效。

PhotoG

PhotoG是全球首个内容营销端对端智能体

121

查看详情

解决方案：使用正确的API端点

要成功获取新闻的原始图片URL，开发者必须将请求的目标端点从/news更改为/news/search。通过/news/search端点，并设置originalImg=true，API将会在响应的image对象中包含contentUrl字段，指向原始尺寸的图片。

正确用法示例代码：

const url = 'https://bing-news-search1.p.rapidapi.com/news/search?q=india news&originalImg=true&category=india&cc=in&safeSearch=Off&textFormat=Raw'; // 注意端点已更改为 /news/search
const options = {
    method: 'GET',
    headers: {
        'X-BingApis-SDK': 'true',
        'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', // 请替换为您的RapidAPI密钥
        'X-RapidAPI-Host': 'bing-news-search1.p.rapidapi.com'
    }
};

fetch(url, options)
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error(error));

登录后复制

上述请求的预期响应片段（包含原始图片URL）：

{
    "value": [
        {
            "url": "https://www.msn.com/en-in/news/world/...",
            "image": {
                "_type": "ImageObject",
                "contentUrl": "https://media.zenfs.com/en/hearst_womens_health_52/9743c154e3be883ec18c41f03fc44d58", // 原始图片URL
                "thumbnail": {
                    "_type": "ImageObject",
                    "contentUrl": "https://www.bing.com/th?id=OVFT.1Wypj4IiKxycYuiB2Q81GC&pid=News",
                    "width": 700,
                    "height": 350
                }
            },
            // ... 其他新闻条目信息
        }
    ]
}

登录后复制

在上述正确用法中，url中的端点已从/news修改为/news/search，并且通常需要提供一个q（查询词）参数来指定搜索内容。此时，API响应的image对象中便会包含contentUrl字段，指向原始尺寸的图片。

注意事项与总结

端点选择至关重要： 务必根据您的需求选择正确的API端点。如果目标是获取带有原始图片的新闻搜索结果，请使用/news/search。如果仅需要热门新闻或特定类别新闻且不关心原始图片，/news端点可能更合适。
查询参数： 使用/news/search端点时，通常需要提供q（查询词）参数。
官方文档查阅： 在开发过程中，始终建议查阅Bing新闻搜索API的官方文档（如Microsoft Learn），以获取最准确和最新的参数使用说明和限制。这有助于避免因参数误用而导致的问题。
响应结构： 即使使用了正确的端点和参数，并非所有新闻条目都会提供原始图片。如果某个新闻源没有提供高分辨率图片，或者Bing无法抓取到，contentUrl字段可能仍然缺失或指向缩略图。

通过理解originalImg参数的端点限制，开发者可以更精确地控制Bing新闻搜索API的行为，从而有效地获取所需的原始图片信息，提升应用程序的功能性和用户体验。

以上就是解决Bing新闻搜索API中originalImg参数不生效的问题的详细内容，更多请关注php中文网其它相关文章！