APITube Documentation
Sign inGet started

Insights endpoints ​

Use insights endpoints to get trends, article counts or fact-check results from the same news archive as the article endpoints. They are useful for dashboards, monitoring and research when you do not need the full articles.

Which one do I need? ​

You wantEndpointCostGuide
A ranking of who or what is being talked aboutGET/POST /v1/news/trends1 pointTrends
Only the number of matching articlesGET /v1/news/count1 pointCount articles
A verdict on a factual claim, with evidencePOST /v1/fact-check5 pointsFact check

Choose a field for /v1/news/trends to see its most common values and their article counts and percentages. You can also request growth rates, trending scores and comparisons with a previous period. For example, find out which entities appear most often in English-language news:

bash
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.apitube.io/v1/news/trends?field=entity.id&language.code=en"

Use any filter from /v1/news/everything to limit the analysis to a specific industry, country or date range.

Count — get the total without downloading articles ​

Use /v1/news/count to get the number of matching articles without downloading them. It supports the same search filters. Result options such as page, per_page, sort.*, export and fl have no effect.

Check the count before a large export, when choosing a sample, or when displaying a total on a dashboard.

Fact check — check claims against news ​

Use /v1/fact-check to check a claim against recent news. Each result includes a verdict on an 8-level scale, a confidence score, a short explanation and articles that support or challenge the claim. Submit a statement, full article text or the id of an article in the archive.

Paid feature

Fact Check requires a paid plan. Each request costs 5 points. You can send up to 10 requests per minute, subject to your account's overall rate limit.

Next steps ​