Skip to content

Migrating from Marketaux

Replace /v1/news/all with /v1/news/everything. Whether this migration works for you comes down to one question, so it is worth answering before reading anything else.

Is this migration right for you?

Marketaux is a financial news API built on ticker symbols, exchanges and instrument types. APITube is a general news API with entity recognition.

It does not work if you filter by ticker. There is no ticker filter, no exchange filter and no instrument-type filter on APITube — and, worse, the obvious parameter names are ignored silently:

bash
# Verified on 27 July 2026
ticker=TSLA 3,050,338,423 articles   (the entire index the parameter is ignored)
symbol=TSLA 3,050,338,443 articles   (same)

The closest substitute is the company name, which answers a different question:

bash
curl "https://api.apitube.io/v1/news/everything?api_key=YOUR_API_KEY&organization.name=Tesla"

That matches coverage of the company, not of the listed instrument.

It does work if what you use is entity-level sentiment. That maps precisely, and it is a rare feature to find elsewhere:

bash
# all coverage of Tesla
curl "https://api.apitube.io/v1/news/count?api_key=YOUR_API_KEY&organization.name=Tesla"

# with negative coverage filtered out
curl "https://api.apitube.io/v1/news/count?api_key=YOUR_API_KEY&organization.name=Tesla&entity.sentiment.score.min=0"

Both APIs score sentiment towards each entity, not just the article, so alerting pipelines built on "negative coverage about company X" port cleanly.

Parameter mapping

MarketauxAPITubeFidelity
symbolsorganization.nameApproximate — company, not instrument
entity_typesperson.name / organization.name / location.namePartial
industriesindustry.idDifferent taxonomies — verify each value
countriessource.country.codeDifferent meaning: exchange country → publisher country
sentiment_gte / sentiment_lteentity.sentiment.score.min / .maxExact
searchtitle or queryHeadlines only
languagelanguage.code34 of 37 codes work
domainssource.domainMax 3
exclude_domainsignore.source.domain
published_after / published_beforepublished_at.start / .end
limitper_page250 max
pagepage
exchanges, must_have_entities, filter_entitiesNo equivalent

Two traps worth naming

countries means something different. On Marketaux it is the country of the exchange; on APITube source.country.code is where the publisher is based. Converting it silently answers a different question.

Entity names must resolve. APITube matches names against an index rather than free text, so ticker-to-name conversion has to use the form the index knows. Short forms of some company names return 400 ER0220 where the full legal name works — the entity mapping table in the kit was built by checking each entry against the live API.

If you also use The News API

Marketaux and The News API run on the same engine — verified: identical endpoint paths, identical error envelope, identical language list (37 codes), identical country list (55), identical search operator syntax and meta object.

So migrating from The News API covers most of this already. The Marketaux kit adds the financial layer on top.

What you gain

Full article body, sentiment on the headline and the body separately in addition to per-entity scores, IPTC MediaTopics plus topic and industry axes, publisher political bias and Open Page Rank, readability scores, 250 articles per request, and export to eight formats.

Next steps