Migrating from NewsData.io

Replace /api/1/latest and /api/1/archive with /v1/news/everything. Convert nextPage tokens to numbered pages and check headline-only search.

Why teams switch

	NewsData.io	APITube
Sentiment analysis	Professional plan — $349.99/month	Every plan, on every article
AI entities (ai_org, ai_region)	Corporate plan — $1,299.99/month	Every plan, with Wikidata IDs
Articles per request	50 on paid plans, 10 on Free	250 on Basic and up — Starter is capped at 50 and Free at 10
Article delay on Free	12-hour delay, no archive	No delay, plus SSE and WebSocket streaming
Archive	6 months / 2 years / 10 years by tier	Years, on every plan

Your first request

# NewsData.io
curl "https://newsdata.io/api/1/latest?apikey=YOUR_KEY&q=tesla&language=en&country=us&size=10"

# APITube
curl "https://api.apitube.io/v1/news/everything?title=tesla&language.code=en&source.country.code=us&per_page=10" \
  -H "X-API-Key: YOUR_API_KEY"

Parameter mapping

NewsData.io	APITube	Note
q	title	Headlines only — see below
qInTitle	title	Lossless
qInMeta	—	No metadata search
language	language.code	Max 3 values
country	source.country.code	Max 3 values
category	category.id	Their categories become IPTC codes
excludecategory	ignore.category.id
domain / domainurl	source.domain	Max 3, exact domain
excludedomain	ignore.source.domain
sentiment	sentiment.overall.polarity	Free here, $349.99/mo there
tag	topic.id
timeframe	published_at.start	24 → NOW-24h; minutes need an absolute timestamp
from_date / to_date	published_at.start / .end
size	per_page	250 max; 10 on Free, 50 on Starter, 200 on Basic
page (token)	page (number)	See below
apikey	api_key or X-API-Key header

The full table is in the migration kit.

What does not carry over

Pagination. NewsData.io uses a nextPage token. APITube uses page numbers and returns a ready-to-use next_page URL. You cannot reuse stored tokens; restart pagination.

Search scope. q covers title and content. title= covers headlines. If your query used qInTitle, the conversion is lossless.

timeframe in minutes. timeframe=15 means 15 minutes on NewsData.io. APITube has no minute unit — NOW-15m would mean 15 months. Use an absolute ISO timestamp for sub-hour windows.

Article IDs. NewsData.io uses string article_id; APITube uses integers. An ID from one API cannot be used in the other.

What you gain

APITube includes sentiment and entities on plans below NewsData.io's $349/$1,299 tiers. It also returns full article text, IPTC MediaTopics, topics, industries, publisher bias and rank, and readability scores. You can search by location and export results in eight formats.

Next steps

• newsdata-io-apitube-migration-kit — full parameter tables derived from NewsData.io's own OpenAPI spec, a compatibility library for Node.js and Python, and an AI prompt for bulk conversion
• Parameters reference
• Common migration issues