README

Newsdata.io PHP客户端

Newsdataapi 允许您轻松、集中地创建访问http服务的库。当调用newsdataapi定义的API时，将返回一个JSON对象。

要求

PHP 7.3及更高版本。

Composer

您可以通过Composer安装绑定。运行以下命令

composer require newsdataio/newsdataapi

手动安装

如果您不希望使用Composer，可以下载最新版本。然后，为了使用绑定，包含autoload.php文件。

require_once('/path/to/newsdataapi-php/autoload.php');

依赖项

为了正常工作，绑定需要以下扩展

• curl，尽管如果您愿意，可以使用自己的非curl客户端
• json

如果您使用Composer，这些依赖项应该会自动处理。如果您手动安装，请确保这些扩展可用。

文档

请参阅API文档。

入门

最新新闻API

GET     /1/news

require_once '../autoload.php';

use NewsdataIO\NewsdataApi;

$newsdataApiObj = new NewsdataApi(NEWSDATA_API_KEY);

# Pass your desired strings in an array with unique key
$data = array("q" => "ronaldo","country" => "ie");

$response = $newsdataApiObj->get_latest_news($data);

API密钥 : 您的私有Newsdata API密钥。

country : 查找显示特定国家新闻的来源。可能的选项：ar , au , at , be , br , bg , ca , cn , co , cu, cz,eg, fr,de, gr, hk, hu, in, id, ie, il, it, jp, lv, lb, lt, my, mx, ma, nl, nz, ng, kp, no, pk, ph, pl, pt, ro, ru, sa, rs, sg, sk, si, za, kr, es, se, ch, tw, th, tr, ua, ae, gb, us, ve

category : 查找显示此类别新闻的来源。可能的选项：business ,entertainment ,environment, food, health, politics, science, sports, technology, top, world

language : 查找显示特定语言的新闻的来源。可能的选项：ar, bs, bg, zh, hr, cs, nl, en, fr, de, el, he, hi, hu, in, it, jp, ko, lv, lt, ms,no, pl, pt, ro, ru, sr, sk, sl, es, sv, th, tr, uk

domain : 一个逗号分隔的域名字符串（最多5个），用于限制搜索。使用/domains端点查找顶级来源ID。

q : 在新闻标题和内容中搜索的关键词或短语。值必须进行URL编码。高级搜索选项：搜索 社交 q=social，搜索 社交披萨 q=social pizza，搜索社交但不包含披萨。 social -pizza q=social -pizza，搜索社交但不包含披萨和野火。 social -pizza -wildfire q=social -pizza -wildfire，使用 AND 运算符搜索多个关键词。 social AND pizza q=social AND pizza

qInTitle : 仅在新闻标题中搜索的关键词或短语。

page : 如果找到的总结果大于页面大小，请使用此参数进行翻页。

存档新闻API

GET     /1/archive

require_once '../autoload.php';

use NewsdataIO\NewsdataApi;

$newsdataApiObj = new NewsdataApi(NEWSDATA_API_KEY);

# Pass your desired strings in an array with unique key
$data = array("q" => "ronaldo","country" => "ie");

$response = $newsdataApiObj->news_archive($data);

API密钥 : 您的私有Newsdata API密钥。

country : 查找显示特定国家新闻的来源。可能的选项：ar , au , at , be , br , bg , ca , cn , co , cu, cz,eg, fr,de, gr, hk, hu, in, id, ie, il, it, jp, lv, lb, lt, my, mx, ma, nl, nz, ng, kp, no, pk, ph, pl, pt, ro, ru, sa, rs, sg, sk, si, za, kr, es, se, ch, tw, th, tr, ua, ae, gb, us, ve

category : 查找显示此类别新闻的来源。可能的选项：business ,entertainment ,environment, food, health, politics, science, sports, technology, top, world

language : 查找显示特定语言的新闻的来源。可能的选项：ar, bs, bg, zh, hr, cs, nl, en, fr, de, el, he, hi, hu, in, it, jp, ko, lv, lt, ms,no, pl, pt, ro, ru, sr, sk, sl, es, sv, th, tr, uk

domain : 一个逗号分隔的域名字符串（最多5个），用于限制搜索。使用/domains端点查找顶级来源ID。

from_date : 允许的最旧文章的日期和可选时间。此日期应采用 ISO 8601 格式（例如 2021-04-18 或 2021-04-18T04:04:34）

to_date : 允许的最新文章的日期和可选时间。此日期应采用 ISO 8601 格式（例如 2021-04-18 或 2021-04-18T04:04:34）

q : 在新闻标题和内容中搜索的关键词或短语。值必须进行URL编码。高级搜索选项：搜索 社交 q=social，搜索 社交披萨 q=social pizza，搜索社交但不包含披萨。 social -pizza q=social -pizza，搜索社交但不包含披萨和野火。 social -pizza -wildfire q=social -pizza -wildfire，使用 AND 运算符搜索多个关键词。 social AND pizza q=social AND pizza

qInTitle : 仅在新闻标题中搜索的关键词或短语。

page : 如果找到的总结果大于页面大小，请使用此参数进行翻页。

新闻来源API

GET     /1/sources

require_once '../autoload.php';

use NewsdataIO\NewsdataApi;

$newsdataApiObj = new NewsdataApi(NEWSDATA_API_KEY);

# Pass your desired strings in an array with unique key
$data = array("q" => "ronaldo","country" => "ie");

$response = $newsdataApiObj->news_sources($data);

API密钥 : 您的私有Newsdata API密钥。

country : 查找显示特定国家新闻的来源。可能的选项：ar , au , at , be , br , bg , ca , cn , co , cu, cz,eg, fr,de, gr, hk, hu, in, id, ie, il, it, jp, lv, lb, lt, my, mx, ma, nl, nz, ng, kp, no, pk, ph, pl, pt, ro, ru, sa, rs, sg, sk, si, za, kr, es, se, ch, tw, th, tr, ua, ae, gb, us, ve

category : 查找显示此类别新闻的来源。可能的选项：business ,entertainment ,environment, food, health, politics, science, sports, technology, top, world

language : 查找显示特定语言的新闻的来源。可能的选项：ar, bs, bg, zh, hr, cs, nl, en, fr, de, el, he, hi, hu, in, it, jp, ko, lv, lt, ms,no, pl, pt, ro, ru, sr, sk, sl, es, sv, th, tr, uk

许可证

由 Matt Lisivick 提供，在 MIT 许可证下提供。

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.