Output

The N | B | D API response includes up to 100 search-results and a Meta Info area with reference to API consumption and the request itself, such as the "next" URL to get the next batch of search-results matching your query.

Each result is constructed of 3 objects:

The Thread Object provides information about the complete thread (e.g. full article text and associated comments).
The Post Object includes information about a particular post in a thread. A post could be the article, i.e the first post, or a comment to the article.
The External Images Object includes information about the images found on a page, including visual image analysis and metadata extracted about each image found.

Thread Object

Field Name	Description	Searchable?	Type
uuid	A unique ID representing the thread	Yes	String
url	The link to the top of the thread	Yes	String
site_full	The complete domain of the site	Yes	String
site	The top level domain of the site	Yes	String
site_section	A link to the section in the site where the thread was created	Yes	String
section_title	The title of the section in the site where the thread was created	Yes	String
site_title	The title text shown in the browser tab for a site's home page.	Yes	String
title	The title of the thread	Yes	String
title_full	The full title of the thread including prefix or suffix automatically added by the site (like the site name)	Yes	String
published	The date/time when the thread was published	Yes	Date Format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX
replies_count	The number of replies to the main post	Yes	Integer
participants_count	The number of different people who participated in the discussion	Yes	Integer
site_type	Is the site a news \| blogs \| discussions source?	Yes	String
main_image	A link to the main image presented with the article	Yes	String
country	The article's country of origin is determined by its domain, subdomain, or site section. This is established through the country indicators in the web address (e.g. *.co.fr) or by analyzing the country that generates the most traffic. To get a full country code list, visit our CountryCode.org	Yes	String
site_categories	A list of categories for this website or top news per country. see full list of values.	Yes	String
social.facebook - comments - likes - shares social.vk - shares	The post's number of comments, likes and shares on social networks.	Yes	Integer
performance_score	A virality score for news and blogs posts only. The score ranges between 0-10. A score of 0 means that the post didn't do well - it was rarely or never shared. A score of 10 means that the post was "on fire" being shared thousands of times on Facebook.	Yes	Integer
domain_rank	A rank that specifies how popular a domain is	Yes	Integer
domain_rank_updated	The date/time when the domain rank were last updated	No	Date Format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX
licensing_agency	External news agency license support (e.g NLA, NCA, CFC)	Yes	String

Post Object

Field Name	Description	Searchable?	Type
uuid	A unique ID representing a post in a thread	No	String
url	A link to the post in the thread (goes through omgili.com on the free plan)	Yes	String
ord_in_thread	The order in the thread, i.e if its the first post, the second etc..	Yes	Integer
parent_url	For threaded comments, this field provides the parent comment URL of the current post.	No	String
author	The name of the post author	Yes	String
published	The date/time when the post was published.	Yes	Date Format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX
title	The title of the post	Yes	String
text	The text body of the post	Yes	String
language	The language of the post	Yes	String
external_links	A list of URLs that are linked from the post	Yes	String
rating	For review posts, the rating parameter provides the star rating for the review. rating is a floating number between 0.0 to 5.0. Only relevant for Review API	Yes	Float
entities.locations -name -sentiment entities.organizations -name -sentiment -tickers.ticker \| exchange entities.persons - name - sentiment	locations - a list of identified locations found in the post with its name and sentiment* fields organizations** - a list of identified companies/organizations found in the post with its name, sentiment, ticker and exchange market * fields persons** - a list of identified people names found in the post with its name and sentiment* fields** * sentiment - Possible values are: positive, negative, none. ** currently available for news/blogs posts in English)	Yes	String

crawled	The date/time when the post was crawled.	Yes	Date Format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX
sentiment	The sentiment of the news article. May be either Positive, Negative or Neutral	Yes
categories	A list of predetermined categories matching the theme of the news article.	Yes
topics	A list of predetermined topics matching the theme of the news article based on the following list.	Yes
webz_reporter	Indicates if the article is generated using Webz Reporter feature	Yes	Boolean
ai_allow	Indicates if the article is allowed (true) for LLM training	Yes	Boolean
has_canonical	Indicates that the post contains a canonical HTML tag pointing to another website. This typically means the article is syndicated from that other website.	Yes	Boolean
breaking	The breaking field is a Boolean indicator that specifies whether a news article was crawled within one hour of publication from popular websites (Top News). When set to true, it returns only articles crawled within this timeframe, providing access to the most up-to-date and rapidly emerging news.	Yes	Boolean
highlightText	The highlightText output field in Webz.io provides a highlighted snippet of text that matches your query when &highlight=true is set. This helps quickly identify relevant content within articles, posts, or discussions by emphasizing the exact terms that triggered the match.	No	String
highlightThreadTitle	The highlightThreadTitle output field in Webz.io returns a highlighted version of the thread title that matches your query when &highlight=true is set.	No	String
highlightTitle	The highlightTitle output field in Webz.io provides a highlighted version of a post's title within a thread when &highlight=true is set. Unlike highlightThreadTitle, which applies to the entire thread's title, highlightTitle focuses on individual posts inside the thread.	No	String
breaking	The breaking field is a Boolean field that indicates whether a news article was published with a latency of less than one hour. If set to `true`, it returns only articles that were detected within an hour of their publication time, ensuring access to the most up-to-date and rapidly emerging news.	Yes	Boolean

Meta Info

Field Name	Description	Type
totalResults	The total number of posts matching your query	Integer
moreResultsAvailable	How many more results are available	Integer
next	A URL to get the next batch of posts matching your query. See Pagination and Sorting]	String
requestsLeft	How many more requests are available in your current subscription plan.	Integer

Syndication

Description	Searchable	Type
syndicated	Indicates if the article is syndicated, meaning part of similar group of articles.	Boolean
syndicate_id	A unique ID for the syndication (group id).	String
first_syndicated	Indicates if the article is the first article in the list of the syndicated articles	Boolean

Trust

Description	Searchable	Searchable	Type
trust.category	The `trust.category` field indicates the classification of the source based on its trustworthiness. Possible values include: - `fake_news` – Indicates that the post originates from a site known for publishing fake news. - `trusted_news` – Indicates that the post originates from a site known for publishing trusted news. - `satirical_news` – Indicates that the post originates from a site known for publishing satirical content. - This field helps users assess the reliability of the source and determine how to handle the data accordingly. - Please note: The classification of fake news, trusted news and satirical news is conducted at the domain-level and NOT at the article-level.	Yes	List
trust.top_news	The `trust.top_news` field allow to filter for top news sources from specific countries, such as top_news_us for the United States or top_news_fr for France. This is useful for organizations looking to track news in certain regions, gaining insights into local events, regulatory changes, or market conditions. To see all supported top_news countries click (here ).	Yes	List
trust.bias	The `trust.bias` field identifies whether the domain associated with the post is recognized as politically biased. Possible values include: left \| center \| right	Yes	String
trust.source	The `trust.source.type` field indicates the classification of the source based on its trustworthiness. Possible values include: - newsroom - Indicates that the post originates from a newsroom or press release site section of over 5K top companies by leading markets. - `gov_news` – Indicates that the post originates from a news section of a government site . - `local_news` – Indicates that the post originates from a news site related to a local states/cities (e.g foxla.com/news -- Fox L.A site). - Note: In case of source type is 'gov_news' or 'local_news', an additional metadata values will be added. gov_news metadata:`source: {type: gov_news, domain_type: value, agency: value, organization_name: value, city: [value], state: [value], country: [US]}`local_news metadata:`source: {type: local_news, city: [list of values], state: [list of values], country: [by default the country of the site]}`	Yes	Object


   {
      "thread": {
        "uuid": "0cf6601bb0c848c87cf730df69b90ee1ae1fa629",
        "url": "https://www.cbc.ca/player/play/video/9.6605650",
        "site_full": "www.cbc.ca",
        "site": "cbc.ca",
        "site_section": "https://www.cbc.ca/player/news",
        "site_title": "CBC.ca - watch, listen, and discover with Canada's Public Broadcaster Loaded",
        "site_categories": [
          "media",
        ],
        "section_title": "News - Video | CBC.ca",
        "title": "Trudeau to resign as prime minister after Liberal leadership race | CBC.ca",
        "title_full": "Trudeau to resign as prime minister after Liberal leadership race | CBC.ca",
        "published": "2025-01-06T19:41:00.000+02:00",
        "replies_count": 0,
        "participants_count": 0,
        "site_type": "news",
        "country": "CA",
        "main_image": "https://i.cbc.ca/ais/11a8d942-d533-440e-855c-0653a4c822dc,1736184917880/full/max/0/default.jpg?im=Crop%2Crect%3D%280%2C0%2C940%2C528%29%3BResize%3D%281180%29",
        "performance_score": 0,
        "domain_rank": 342,
        "domain_rank_updated": "2024-12-30T23:00:00.000+02:00",
        "licensing_agency": [
          "NLA"
        ],
        "social": {
          "facebook": {
            "likes": 0,
            "comments": 0,
            "shares": 0
          },
          "vk": {
            "shares": 0
          }
        }
      },
      "uuid": "0cf6601bb0c848c87cf730df69b90ee1ae1fa629",
      "url": "https://www.cbc.ca/player/play/video/9.6605650",
      "ord_in_thread": 0,
      "parent_url": null,
      "author": null,
      "published": "2025-01-06T19:41:00.000+02:00",
      "title": "Trudeau to resign as prime minister after Liberal leadership race | CBC.ca",
      "text": "Prime Minister Justin Trudeau says he plans to step down once the Liberal Party has chosen a successor, bringing his time leading the country to a tumultuous end. Trudeau, who became Liberal leader in 2013 and prime minister in the fall of 2015, announced his long-awaited decision outside his official residence, Rideau Cottage, on Monday morning.",
      "highlightText": "",
      "highlightTitle": "",
      "highlightThreadTitle": "",
      "language": "english",
      "sentiment": "neutral",
      "categories": [
        "Politics",
        "Social Issue",
        "Human Interest"
      ],
      "topics": [
        "Politics->political parties and movements",
        "Politics->political candidates",
        "Politics->national government",
        "Social Issue->social condition",
        "Human Interest->ceremony"
      ],
      "ai_allow": true,
      "has_canonical": false,
      "webz_reporter": false,
      "external_links": [],
      "external_images": [],
      "entities": {
        "persons": [
          {
            "name": "Justin Trudeau",
            "sentiment": "negative"
          }
        ],
        "organizations": [
          {
            "name": "Liberal Party",
            "sentiment": "negative"
          }
        ],
        "locations": []
      },
      "syndication": {
        "syndicated": false,
        "syndicate_id": null,
        "first_syndicated": false
      },
        "trust": {
        "categories": [
          "trusted_news"
        ],
        "source": {
          "type": "gov_news",
          "city": [],
          "state": [],
          "country": [],
          "domain_type": null,
          "agency": null,
          "organization_name": null
        },
        "top_news": [
          "top_news_in",
          "top_news_ph",
          "top_news_pk",
          "top_news_ae",
          "top_news_qa",
          "top_news_sg",
          "top_news_sa",
          "top_news_kw",
          "top_news"
        ],
        "bias":"right"
      },
      "rating": null,
      "crawled": "2025-01-06T20:09:41.758+02:00",
      "updated": "2025-01-06T20:09:41.758+02:00"
    }