▣ ARTIFICIAL INTELLIGENCE · DATA EXTRACTION

World News API

What it does

World News API lets you search, extract, and retrieve news data from URLs, article IDs, and source names. Send a news URL, a query, or a country/language filter, and get back article text, titles, authors, summaries, publish dates, sentiment, and related links where available.

Use it to build news monitoring, media intelligence, and content aggregation features. The Search News endpoint supports filters such as text, authors, entities, language, categories, news-sources, source-country, sentiment ranges, and publish-date bounds, with paging through number and offset. Top News returns current headlines for a required source-country and language, with an optional date and headlines-only flag.

If you already have an article identifier, Retrieve News Articles by Ids returns matching items in a news array. Extract News and Extract News Links work from a single article URL: one returns article content and metadata, while the other returns extracted links. Search News Sources helps you find outlets by name, and Retrieve Newspaper Front Page returns front-page metadata for a source and date.

World News API is a good fit when you need structured news records for dashboards, alerts, ranking, or downstream enrichment without scraping each publisher format yourself.

▣ ENDPOINT 01 / 09

GET

Extract News

https://api.eu.apyhub.com/skycraft/world-news-api/extract-news

QUICKSTART

GUIDE

Quickstart

Fetch article metadata and extracted content from a news page by passing its URL as a query parameter.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/extract-news?url=https%3A%2F%2Fwww.bbc.com%2Fnews%2Fworld-us-canada-59340789" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with optional top-level fields such as url, text, image, title, video, author, images, videos, authors, language, and publish_date.

{
  "url": "https://www.bbc.com/news/world-us-canada-59340789",
  "title": "Example headline",
  "author": "BBC News",
  "language": "en",
  "publish_date": "2021-11-18T12:00:00Z"
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Extracts structured information from a news article URL. It returns the article’s core metadata and content fields, and can also include arrays of related images, videos, and authors.

Query Parameter(s)

Attribute	Type	Mandatory	Description
url	String	Yes	The news article URL to extract. Max length: 1000 characters.
analyze	Boolean	No	Whether to perform additional analysis.

Response

Returns a JSON object containing article metadata and extracted content fields. The top-level fields are url, text, image, title, video, author, images, videos, authors, language, and publish_date.

Parameter	Type	Mandatory	Description
url	String	No	The source URL extracted from the article, if available.
text	String	No	The article text, if available.
image	String	No	A primary image URL, if available.
title	String	No	The article title, if available.
video	String	No	A primary video URL, if available.
author	String	No	The primary author, if available.
images	Object Array	No	An array of image objects, if available. Each item may contain `url`, `title`, `width`, and `height`.
images[].url	String	No	The image URL, if available.
images[].title	String	No	The image title, if available.
images[].width	Integer	No	The image width, if available.
images[].height	Integer	No	The image height, if available.
videos	Object Array	No	An array of video objects, if available. Each item may contain `url`, `title`, `summary`, `duration`, and `thumbnail`.
videos[].url	String	No	The video URL, if available.
videos[].title	String	No	The video title, if available.
videos[].summary	String	No	A video summary, if available.
videos[].duration	Integer	No	The video duration, if available.
videos[].thumbnail	String	No	A thumbnail URL, if available.
authors	String Array	No	An array of author names, if available.
language	String	No	The detected language, if available.
publish_date	String	No	The publish date, if available.

▣ ENDPOINT 02 / 09

GET

Search News Sources

https://api.eu.apyhub.com/skycraft/world-news-api/search-news-sources

QUICKSTART

GUIDE

Quickstart

Find news sources by name with a simple GET request; this example looks up bbc.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/search-news-sources?name=bbc" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a sources array and an available integer. Each item in sources is an object that may include url, name, and language.

{
  "sources": [
    {
      "url": "https://www.bbc.com/news",
      "name": "BBC News",
      "language": "en"
    }
  ],
  "available": 1
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches for news sources matching a provided name and returns a JSON object containing matching sources plus an available count.

Query Parameter(s)

Attribute	Type	Mandatory	Description
name	String	Yes	Search term for the news source name. Max length: 1000 characters.

Response

Returns a JSON object with two top-level fields: sources is an array of source objects, and available is an integer count. Each source object may include url, name, and language string fields, all of which can be nullable.

Parameter	Type	Mandatory	Description
sources	Object Array	No	Array of matching news source objects. Each item may include: `url` (String, nullable) `name` (String, nullable) `language` (String, nullable)
available	Integer	No	Number of available matching sources.

▣ ENDPOINT 03 / 09

GET

Get Geo Coordinates

https://api.eu.apyhub.com/skycraft/world-news-api/geo-coordinates

QUICKSTART

GUIDE

Quickstart

Look up the weather/news location for a city by passing its location as a query parameter.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/geo-coordinates?location=Tokyo%2C%20Japan" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with optional city as a string, latitude as a number, and longitude as a number.

{
  "city": "Tokyo",
  "latitude": 35.6895,
  "longitude": 139.6917
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Resolves a geographic location string into coordinates. The response returns the matching city name, latitude, and longitude.

Query Parameter(s)

Attribute	Type	Mandatory	Description
location	String	Yes	The location to geocode. String, max length 1000.

Response

Returns a JSON object with city as a nullable string, latitude as a number, and longitude as a number.

Attribute	Type	Mandatory	Description
city	String	No	The resolved city name, or null if not available.
latitude	Number	No	The resolved latitude.
longitude	Number	No	The resolved longitude.

▣ ENDPOINT 04 / 09

GET

Search News

https://api.eu.apyhub.com/skycraft/world-news-api/search-news

QUICKSTART

GUIDE

Quickstart

Search for recent world news matching a keyword, using the required API token header and a query parameter.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/search-news?text=tesla&number=10" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with news as an array of news items, plus number, offset, and available as integers. Each item in news can include fields like id, url, text, image, title, video, authors, summary, category, language, sentiment, publish_date, and source_country.

{
  "news": [
    {
      "id": 123,
      "url": "https://example.com/article",
      "title": "Tesla shares rise after earnings",
      "authors": ["John Doe"],
      "sentiment": 0.7,
      "publish_date": "2022-04-22 16:12:35"
    }
  ],
  "number": 10,
  "offset": 0,
  "available": 124
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches for news articles using the provided query parameters and returns a paginated result set. The response includes matching news items plus pagination-related counts.

Query Parameter(s)

Attribute	Type	Mandatory	Description
sort	String	No	Sort key. Example: `publish-time`. Max length: 100.
text	String	No	Text to search for. Example: `tesla`. Max length: 100.
number	Integer	No	Number of items to return. Integer `int32`. Minimum: 1, maximum: 100.
offset	Integer	No	Result offset for pagination. Integer `int32`. Minimum: 0, maximum: 10000.
authors	String	No	Filter by authors. Example: `John Doe`. Max length: 300.
entities	String	No	Filter by entities. Example: `ORG:Tesla,PER:Elon Musk`. Max length: 10000.
language	String	No	Filter by language. Example: `en`. Max length: 2.
categories	String	No	Filter by categories. Example: `politics,sports`. Max length: 300.
news-sources	String	No	Filter by news source URLs. Example: `https://www.bbc.co.uk`. Max length: 10000.
max-sentiment	Number	No	Maximum sentiment score. Double. Minimum: -1, maximum: 1.
min-sentiment	Number	No	Minimum sentiment score. Double. Minimum: -1, maximum: 1.
sort-direction	String	No	Sort direction. Example: `ASC`. Max length: 4.
source-country	String	No	Filter by source country. Example: `us`. Max length: 2.
location-filter	String	No	Location filter. Example: `51.050407, 13.737262, 20`. Max length: 100.
text-match-indexes	String	No	Fields to search in. Example: `title,content`. Max length: 100.
latest-publish-date	String	No	Latest publish date. Example: `2022-04-22 16:12:35`. Max length: 19.
earliest-publish-date	String	No	Earliest publish date. Example: `2022-04-22 16:12:35`. Max length: 19.

Response

Returns a JSON object with news as an array of news objects, and integer number, offset, and available fields. Each news item includes id, url, text, image, title, video, authors, summary, category, language, sentiment, publish_date, and source_country.

Parameter	Type	Mandatory	Description
news	Object Array	No	Array of news results. Each item contains `id` (integer), `url` (string, nullable), `text` (string, nullable), `image` (string, nullable), `title` (string, nullable), `video` (string, nullable), `authors` (string array of nullable strings), `summary` (string, nullable), `category` (string, nullable), `language` (string, nullable), `sentiment` (number), `publish_date` (string, nullable), and `source_country` (string, nullable).
number	Integer	No	Number of results returned.
offset	Integer	No	Offset of the returned results.
available	Integer	No	Total number of available matching results.

▣ ENDPOINT 05 / 09

GET

QUICKSTART

GUIDE

Quickstart

Fetch top news for a country and language using the required query parameters.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/top-news?source-country=us&language=en" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with country and language string fields, and top_news, an array of objects. Each top_news item contains a news array of article objects with fields like id, url, text, image, title, author, authors, summary, and publish_date.

{
  "country": "us",
  "language": "en",
  "top_news": [
    {
      "news": [
        {
          "id": 123,
          "url": "https://example.com/story",
          "title": "Sample headline",
          "publish_date": "2024-05-30"
        }
      ]
    }
  ]
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the top news for the requested source country and language, with an optional date filter. The response is a JSON object that includes the country, language, and a top_news array of news-group objects.

Query Parameter(s)

Attribute	Type	Mandatory	Description
date	String	No	Date filter. Format: `YYYY-MM-DD` (max length: 10).
language	String	Yes	Language code. Max length: 2.
headlines-only	Boolean	No	When `true`, returns headlines only.
source-country	String	Yes	Source country code. Max length: 2.

Response

Returns a JSON object with nullable country and language string fields, plus a top_news array. Each item in top_news is an object containing a news array of news objects.

Attribute	Type	Mandatory	Description
country	String	No	Country code associated with the response. Nullable.
language	String	No	Language code associated with the response. Nullable.
top_news	Object Array	No	Array of top-news group objects.
top_news[].news	Object Array	No	Array of news objects.
top_news[].news[].id	Integer	No	News item identifier.
top_news[].news[].url	String	No	News item URL. Nullable.
top_news[].news[].text	String	No	News text. Nullable.
top_news[].news[].image	String	No	News image URL. Nullable.
top_news[].news[].title	String	No	News title. Nullable.
top_news[].news[].author	String	No	News author. Nullable.
top_news[].news[].authors	String Array	No	List of authors. Items are nullable strings.
top_news[].news[].summary	String	No	News summary. Nullable.
top_news[].news[].publish_date	String	No	News publish date. Nullable.

▣ ENDPOINT 06 / 09

GET

Extract News Links

https://api.eu.apyhub.com/skycraft/world-news-api/extract-news-links

QUICKSTART

GUIDE

Quickstart

Fetch news links for a source URL by passing the required url query parameter.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/extract-news-links?url=https%3A%2F%2Fwww.bbc.com%2Fnews%2Fworld-us-canada-59340789" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a news_links array of strings, where each item is a news link URL or null.

{
  "news_links": [
    "https://www.example.com/news/story-1",
    null
  ]
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Extracts news links from a provided URL and returns them in a JSON object. The endpoint takes the source page URL as a query parameter and can optionally receive an analyze flag.

Query Parameter(s)

Attribute	Type	Mandatory	Description
url	String	Yes	The source URL to extract news links from. Max length: 1000 characters.
analyze	Boolean	No	Optional boolean flag.

Response

Returns a JSON object with a news_links array field. Each item in the array is a string, and the schema allows individual items to be null.

Attribute	Type	Mandatory	Description
news_links	String Array	No	Array of extracted news links. Items are strings; individual items may be `null`.

▣ ENDPOINT 07 / 09

GET

News Website to RSS Feed

https://api.eu.apyhub.com/skycraft/world-news-api/feed.rss

QUICKSTART

GUIDE

Quickstart

Fetch news from a URL by passing the required url query parameter.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/feed.rss?url=https://www.bbc.com" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title><![CDATA[BBC Home - Breaking News, World News, US News, Sports, Business, Innovation, Climate, Culture, Travel, Video & Audio]]></title>
    <link>https://www.bbc.com/</link>
    <lastBuildDate>Thu, 24 Sep 2026 08:58:35 +0000</lastBuildDate>
    <item>
      <title><![CDATA[20260714 Nonnamaxxing Tourists Are Paying To Travel Like Grandmothers]]></title>
      <link>https://www.bbc.com/travel/article/20260714-nonnamaxxing-tourists</link>
    </item>
    ...
  </channel>
</rss>

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a news website URL into an RSS feed representation. It accepts the website URL as a query parameter and optionally an extract-news flag.

Query Parameter(s)

Attribute	Type	Mandatory	Description
url	String	Yes	The news website URL to convert. Maximum length: 1000 characters.
extract-news	Boolean	No	Optional boolean flag.

Response

Returns an RSS 2.0 XML feed built from the target website's news content — not a JSON object.

▣ ENDPOINT 08 / 09

GET

Retrieve Newspaper Front Page

https://api.eu.apyhub.com/skycraft/world-news-api/retrieve-front-page

QUICKSTART

GUIDE

Quickstart

Fetch the front page news details for a given date, source name, and source country.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/retrieve-front-page?date=2024-07-09&source-name=herald-sun&source-country=au" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a front_page object. The front_page object contains nullable string fields for date, name, image, country, and language.

{
  "front_page": {
    "date": "2024-07-09",
    "name": "Herald Sun",
    "image": "https://example.com/front-page.jpg",
    "country": "au",
    "language": "en"
  }
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves a newspaper front page for the specified query criteria and returns it in a JSON object under front_page. The response includes front page metadata such as date, name, image, country, and language when available.

Query Parameter(s)

Attribute	Type	Mandatory	Description
date	String	No	Date filter in `YYYY-MM-DD` format. Max length: 10.
source-name	String	No	Newspaper source name. Max length: 100.
source-country	String	No	Source country code. Max length: 2.

Response

Returns a JSON object with a front_page object field. The front_page object contains optional string fields: date, name, image, country, and language.

Parameter	Type	Mandatory	Description
front_page	Object	No	Front page metadata object.
front_page.date	String	No	Front page date, if present.
front_page.name	String	No	Newspaper name, if present.
front_page.image	String	No	Front page image URL or reference string, if present.
front_page.country	String	No	Country code, if present.
front_page.language	String	No	Language code, if present.

▣ ENDPOINT 09 / 09

GET

Retrieve News Articles by Ids

https://api.eu.apyhub.com/skycraft/world-news-api/retrieve-news

QUICKSTART

GUIDE

Quickstart

Fetch one or more news items by their comma-separated IDs.

curl -X GET "https://api.eu.apyhub.com/skycraft/world-news-api/retrieve-news?ids=2352,2354" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a news array. Each item in news is an object with fields such as id, url, text, image, title, authors, summary, category, language, sentiment, publish_date, and source_country.

{
  "news": [
    {
      "id": 2352,
      "url": "https://example.com/news/2352",
      "text": "Article text here",
      "image": "https://example.com/image.jpg",
      "title": "Sample headline",
      "authors": ["Jane Doe"],
      "summary": "Short summary",
      "category": "world",
      "language": "en",
      "sentiment": 0.5,
      "publish_date": "2026-09-10T12:00:00Z",
      "source_country": "US"
    }
  ]
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves one or more news articles by their IDs and returns them in a JSON object under news.

Query Parameter(s)

Attribute	Type	Mandatory	Description
ids	String	Yes	Comma-separated list of news article IDs. Maximum length: 10000 characters.

Response

Returns a JSON object with a news array field. Each item in the array is an object representing a news article with the fields defined below.

Parameter	Type	Mandatory	Description
news	Object Array	No	List of news articles returned for the requested IDs.
news[].id	Integer	No	News article ID.
news[].url	String	No	Article URL. Nullable.
news[].text	String	No	Article text. Nullable.
news[].image	String	No	Article image URL. Nullable.
news[].title	String	No	Article title. Nullable.
news[].authors	String Array	No	Article authors. Array items are nullable strings.
news[].summary	String	No	Article summary. Nullable.
news[].category	String	No	Article category. Nullable.
news[].language	String	No	Article language. Nullable.
news[].sentiment	Number	No	Article sentiment score.
news[].publish_date	String	No	Article publish date. Nullable.
news[].source_country	String	No	Article source country. Nullable.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLExtract Article From Web APIWebsite Intelligence CALLExtract and Analyze Content from Web Page APISumalya APIs CALLExtract Article Text APIDosvak LLC CALLExtract and Translate Article Content from Web Page APISumalya APIs

From the blog

Reads that touch this API.

Top Data Extraction APIs for Developers in 2025Jul 9, 2026 Top Tools, APIs and Use Cases for Extracting Text from Any WebsiteAug 10, 2026 Web Data Extraction: Use Cases and ApproachesJul 9, 2026 SE Ranking Publishes Its SEO and AI Search APIs on ApyHubSep 24, 2026