Migrating from NewsData.io
Replace /api/1/latest and /api/1/archive with /v1/news/everything. The parameter names differ but most concepts line up. The changes that need attention are pagination (a nextPage token becomes a page number) and search scope.
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 every plan |
| Freshness 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 |
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 model. NewsData.io returns an opaque nextPage token; APITube uses numbered pages and returns a ready-made next_page URL. Stored tokens cannot be translated — restart the sequence.
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. The ID spaces are unrelated.
What you gain
Sentiment and entities without the $349/$1,299 tiers, IPTC MediaTopics plus topic and industry axes, full article body, publisher bias and authority rank, readability scores, geo search, and export to eight formats.
Next steps
- newsdata-io-apitube-migration-kit — full parameter tables derived from NewsData.io's own OpenAPI spec, a drop-in shim for Node.js and Python, and an AI prompt for bulk conversion
- Parameters reference
- Common migration issues