Getting Started

Introduction

Our API is designed to provide global financial and stock market news and analysis to elevate financial apps and identify best performing entities in the news. You are able to generate news feeds based on numerous filters, including entity symbol, type, exchange, industry, country and much more. As well as this, you are able to identify the best or worst performing entities and use this to generate charts.

We support over 5,000 news sources globally in over 30 languages, tracking over 200,000 entities every minute from over 80 markets worldwide.

To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.

If you have any questions or concerns, feel free to contact us.

If you have issues with your requests, please ensure your GET parameters are URL-encoded.

All text data returned is UTF-8.

All dates are in UTC (GMT).

For more examples and live responses, check out our entity and endpoint overview.

Authentication

As mentioned above, when you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.

API Endpoints

Finance & Market News Available on: All plans

Endpoint

            
                GET https://api.marketaux.com/v1/news/all HTTP/1.1
            
        

Get all the latest global financial news and filter by entities identified within articles to build concise news feeds. Also provided is analysis of each entity identified in articles. Note that not every article may have entities identified. To retrieve all news for articles with identified entities, use the parameter must_have_entities, or specify any of the entity params such as symbols or exchanges as defined below to produce more concise results.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint or see our API overview.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint or see our API overview.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint or see our API overview.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint or see our API overview.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint or see our API overview.
Example: countries=us,ca
sentiment_gte false Use this to find all articles with entities with a sentiment_score of greater than or equal to x.
Example: sentiment_gte=0 - this will find all articles which are neutral or positive

Sentiment is between -1 and +1. Anything 0 = neutral, above 0 = positive, below 0 = negative. The higher or lower the sentiment score the more positive or negative it is identified as.
sentiment_lte false Use this to find all articles with entities with a sentiment_score of less than or equal to x.
Example: sentiment_lte=0 - this will find all articles which are neutral or negative
min_match_score false Use this to find all articles with entities with a match_score of geater than or equal to min_match_score.
filter_entities false By default all entities for each article are returned - by setting this to true, only the relevant entities to your query will be returned with each article. For example, if you set symbols=TSLA and filter_entities=true, only "TSLA" entities will be returned with the articles.
Default: false
must_have_entities false By default all articles are returned, set this to true to ensure that at least one entity has been identified within the article.
Default: false
group_similar false Group similar articles to avoid displaying multiple articles on the same topic/subject.
Default: true
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Find all articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_after false Find all articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-05-24
sort false Sort by published_on, entity_match_score, entity_sentiment_score or relevance_score (only available when used in conjunction with search). Default is published_at unless search is used and sorting by published_at is not included, in which case relevance_score is used.
When using entity_match_score, entity_sentiment_score this will sort by the average of the filtered entities (filter_entities does not need to be applied for this).
sort_order false Sort order of the sort parameter. NOTE: this can only be used with sort = entity_match_score or entity_sentiment_score.
Options: desc | asc
Default: desc
limit false Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.
page false Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2

Response Objects

name description
meta > found The number of articles found for the request.
meta > returned The number of articles returned on the page. This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page.
meta > limit The limit based on the limit parameter.
meta > page The page number based on the page parameter.
data > uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
data > title The article title.
data > description The article meta description.
data > keywords The article meta keywords.
data > snippet A short snippet of the article body.
data > url The URL to the article.
data > image_url The URL to the article image.
data > language The language of the source.
data > published_at The datetime the article was published.
data > source The domain of the source.
data > relevance_score Relevance score based on the search parameter. If the search parameter is not used, this will be null.
data > entities > symbol Symbol of the identified entity.
data > entities > name Name of the identified entity.
data > entities > exchange Exchange identifier of the identified entity.
data > entities > exchange_long Exchange name of the identified entity.
data > entities > country Exchange country of the identified entity.
data > entities > type Type of the identified entity.
data > entities > industry Industry of the identified entity.
data > entities > match_score The overall strength of the matching for the identified entity.
data > entities > sentiment_score Average sentiment of all highlighted text found for the identified entity.
data > entities > highlights > highlight Snippet of text from the article where the entity has been identified.
data > entities > highlights > sentiment The sentiment of the highlighed text.
data > entities > highlights > highlighted_in Where the highlight was found (title | main_text).
data > similar Array of news articles which are very similar to the main article.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/news/all?symbols=TSLA%2CAMZN%2CMSFT&filter_entities=true&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "found": 55587,
        "returned": 3,
        "limit": 3,
        "page": 1
    },
    "data": [
        {
            "uuid": "0224c04a-55fc-4034-baa0-a73fcb5d4d3a",
            "title": "Tesla Stock Is Down Again. It Isn’t Shanghai Or Wall Street. It’s Snap.",
            "description": "Tesla is down despite some progress on restoring the company's Shanghai plant to full production.",
            "keywords": "article_normal, Motor Vehicles, Alternative Fuel Vehicles, Automotive, Online Service Providers, Media/Entertainment, Social Media Platforms/Tools, Technology, Financial Performance, Analysts' Comments/Recommendations, Share Price Movement/Disruptions, Corporate/Industrial News, Content Types, Factiva Filters, C&E Exclusion Filter, C&E Industry News Filter, synd, Autos, Markets, North America, Consumer, Rapid Response, Tesla, TSLA, Snap, SNAP, NASDAQ Composite Index, COMP, S&P 500 Index, SPX, financial performance, analysts' comments, recommendations, share price movement, disruptions, corporate, industrial news, content types, factiva filters, c&e exclusion filter, c&e industry news filter, autos, markets, north america, technology, consumer, rapid response, motor vehicles, alternative fuel vehicles, automotive, online service providers, media, entertainment, social media platforms, tools",
            "snippet": "Tesla stock is falling again in early Tuesday trading. The likeliest reason isn’t related to the EV makers Shanghai plant or even price target actions at a br...",
            "url": "https://www.marketwatch.com/articles/tesla-stock-down-snap-51653391345",
            "image_url": "https://images.barrons.com/im-533441/social",
            "language": "en",
            "published_at": "2022-05-24T12:23:00.000000Z",
            "source": "marketwatch.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "TSLA",
                    "name": "Tesla, Inc.",
                    "exchange": "NASDAQ",
                    "exchange_long": "NASDAQ Stock Exchange",
                    "country": "us",
                    "type": "equity",
                    "industry": "Consumer Cyclical",
                    "match_score": 26.769905,
                    "sentiment_score": -0.11875,
                    "highlights": [
                        {
                            "highlight": "Tesla stock is falling again in early Tuesday trading. The likeliest reason isn’t related to the EV makers Shanghai plant or even price target actions at a broker. Both of those topics have items for Tesla investors to digest Tuesday. No, the drop is probably down to social media platform Snap.",
                            "sentiment": -0.5994,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Tesla (TSLA) stock is off 2.6%.\n\nTesla is down despite some progress on restoring the company’s Shanghai plant to full production. Tesla is quarantining workers in preparation for a second shift at the Shanghai plant, Bloomberg reported Tuesday. Workers have to be Covid-19 free and isolated for the plant to operated in a “closed loop” setting.",
                            "sentiment": 0.3965,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Tesla didn’t respond to a request for comment about the restart.\n\nThe Shanghai restart is a positive even if the persistent Covid issues in China remain a negative. Another negative that may be weighing on shares is a price target cut at Daiwa. Analyst Jairam Nathan lowered his price target to $800 from $1,150.",
                            "sentiment": -0.6369,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Nathan now sees Tesla delivering 1.2 million vehicles in 2022 and 1.8 million in 2023. The Wall Street consensus calls for 1.4 million and 2.1 million units in 2022 and 2023, respectively.\n\nIt’s been a difficult run for Tesla stock lately.",
                            "sentiment": -0.0258,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Coming into Tuesday trading, Tesla stock is down about 36% year to date, worse than the 16% and 26% comparable, respective drops of the S&P 500 and Nasdaq. Tesla shares have moved more than 1%, up or down, eight of the past 10 trading days. Shares have fallen six times and are down about 15% over that span.",
                            "sentiment": 0.1531,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Tesla Stock Is Down Again. It Isn’t Shanghai Or Wall Street. It’s Snap.",
                            "sentiment": 0,
                            "highlighted_in": "title"
                        }
                    ]
                }
            ],
            "similar": [
                {
                    "uuid": "64f8ec29-d9d0-49c6-b16c-25697361ad67",
                    "title": "Cathie Wood-Backed Tesla Rival Xpeng Gets A 7% Lower Price Target But Why Analyst Is Still Bullish",
                    "description": "Tesla Inc. (NASDAQ:TSLA) rival Xpeng Inc (NYSE: XPENG) is expected to overcome near-term COVID-19 lockdown challenges in China on r...",
                    "keywords": "",
                    "snippet": "Tesla Inc. (NASDAQ:TSLA) rival Xpeng Inc (NYSE: XPENG) is expected to overcome near-term COVID-19 lockdown challenges in China on resilient demand, US Tiger Sec...",
                    "url": "https://markets.businessinsider.com/news/stocks/cathie-wood-backed-tesla-rival-xpeng-gets-a-7-lower-price-target-but-why-analyst-is-still-bullish-1031484093",
                    "image_url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2022/05/24/shutterstock_2090093107.jpg",
                    "language": "en",
                    "published_at": "2022-05-24T09:16:42.000000Z",
                    "source": "markets.businessinsider.com",
                    "relevance_score": null,
                    "entities": [
                        {
                            "symbol": "TSLAD.BA",
                            "name": "TESLA INC",
                            "exchange": "BCBA",
                            "exchange_long": "Buenos Aires Stock Exchange",
                            "country": "ar",
                            "type": "equity",
                            "industry": "N/A",
                            "match_score": 28.057827,
                            "sentiment_score": -0.3276,
                            "highlights": [
                                {
                                    "highlight": "Tesla Inc. (NASDAQ:TSLA) rival Xpeng Inc (NYSE: XPENG) is expected to overcome near-term COVID-19 lockdown challenges in China on resilient demand, US Tiger Securities Inc said, after the Guangzhou-based electric vehicle maker posted a disappointing delivery forecast for the current quarter.",
                                    "sentiment": -0.296,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Xpeng, which has a backer in Tesla bull Cathie Wood, on Monday said it expects to deliver between 31,000 and 34,000 electric vehicles in the second quarter.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "See Also: Why This Analyst Is Bullish On Tesla, Nio Rival Xpeng\n\n“Due to lockdowns, the deliveries of price-protected orders will likely finish in late June, thus hurting second-quarter vehicle gross margin. But management believes gross margin should start to improve sequentially in the third and fourth quarter,” Pei wrote in a note.",
                                    "sentiment": -0.7184,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Cathie Wood-Backed Tesla Rival Xpeng Gets A 7% Lower Price Target But Why Analyst Is Still Bullish",
                                    "sentiment": -0.296,
                                    "highlighted_in": "title"
                                }
                            ]
                        },
                        {
                            "symbol": "TSLAC.BA",
                            "name": "TESLA INC",
                            "exchange": "BCBA",
                            "exchange_long": "Buenos Aires Stock Exchange",
                            "country": "ar",
                            "type": "equity",
                            "industry": "N/A",
                            "match_score": 28.057827,
                            "sentiment_score": -0.3276,
                            "highlights": [
                                {
                                    "highlight": "Tesla Inc. (NASDAQ:TSLA) rival Xpeng Inc (NYSE: XPENG) is expected to overcome near-term COVID-19 lockdown challenges in China on resilient demand, US Tiger Securities Inc said, after the Guangzhou-based electric vehicle maker posted a disappointing delivery forecast for the current quarter.",
                                    "sentiment": -0.296,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Xpeng, which has a backer in Tesla bull Cathie Wood, on Monday said it expects to deliver between 31,000 and 34,000 electric vehicles in the second quarter.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "See Also: Why This Analyst Is Bullish On Tesla, Nio Rival Xpeng\n\n“Due to lockdowns, the deliveries of price-protected orders will likely finish in late June, thus hurting second-quarter vehicle gross margin. But management believes gross margin should start to improve sequentially in the third and fourth quarter,” Pei wrote in a note.",
                                    "sentiment": -0.7184,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Cathie Wood-Backed Tesla Rival Xpeng Gets A 7% Lower Price Target But Why Analyst Is Still Bullish",
                                    "sentiment": -0.296,
                                    "highlighted_in": "title"
                                }
                            ]
                        },
                        {
                            "symbol": "TSLA",
                            "name": "Tesla, Inc.",
                            "exchange": "NASDAQ",
                            "exchange_long": "NASDAQ Stock Exchange",
                            "country": "us",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 38.82713,
                            "sentiment_score": -0.3276,
                            "highlights": [
                                {
                                    "highlight": "Tesla Inc. (NASDAQ:TSLA) rival Xpeng Inc (NYSE: XPENG) is expected to overcome near-term COVID-19 lockdown challenges in China on resilient demand, US Tiger Securities Inc said, after the Guangzhou-based electric vehicle maker posted a disappointing delivery forecast for the current quarter.",
                                    "sentiment": -0.296,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Xpeng, which has a backer in Tesla bull Cathie Wood, on Monday said it expects to deliver between 31,000 and 34,000 electric vehicles in the second quarter.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "See Also: Why This Analyst Is Bullish On Tesla, Nio Rival Xpeng\n\n“Due to lockdowns, the deliveries of price-protected orders will likely finish in late June, thus hurting second-quarter vehicle gross margin. But management believes gross margin should start to improve sequentially in the third and fourth quarter,” Pei wrote in a note.",
                                    "sentiment": -0.7184,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Cathie Wood-Backed Tesla Rival Xpeng Gets A 7% Lower Price Target But Why Analyst Is Still Bullish",
                                    "sentiment": -0.296,
                                    "highlighted_in": "title"
                                }
                            ]
                        },
                        {
                            "symbol": "NIO",
                            "name": "NIO Inc.",
                            "exchange": "NYSE",
                            "exchange_long": "New York Stock Exchange",
                            "country": "us",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 50.622467,
                            "sentiment_score": -0.62255,
                            "highlights": [
                                {
                                    "highlight": "See Also: Why This Analyst Is Bullish On Tesla, Nio Rival Xpeng\n\n“Due to lockdowns, the deliveries of price-protected orders will likely finish in late June, thus hurting second-quarter vehicle gross margin. But management believes gross margin should start to improve sequentially in the third and fourth quarter,” Pei wrote in a note.",
                                    "sentiment": -0.7184,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Rival Nio Inc (NYSE: NIO) is scheduled to report first-quarter numbers on June 9.\n\nPrice Action: Xpeng closed 5.5% lower at $21.9 on Monday and was trading 1.8% lower in after-hours. The stock is down 56.3% year to date.",
                                    "sentiment": -0.5267,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        },
                        {
                            "symbol": "XPEV",
                            "name": "XPeng Inc.",
                            "exchange": "NYSE",
                            "exchange_long": "New York Stock Exchange",
                            "country": "us",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 49.857815,
                            "sentiment_score": -0.272186,
                            "highlights": [
                                {
                                    "highlight": "(NASDAQ:TSLA) rival Xpeng Inc (NYSE: XPENG) is expected to overcome near-term COVID-19 lockdown challenges in China on resilient demand, US Tiger Securities Inc said, after the Guangzhou-based electric vehicle maker posted a disappointing delivery forecast for the current quarter.",
                                    "sentiment": -0.296,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "The Xpeng Analyst: Analyst Bo Pei has maintained a ‘buy’ rating on the stock but lowered his price target to $40 from $43 — the second such cut since March.",
                                    "sentiment": -0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "The Xpeng Thesis: The New York-based analyst said he expects the operating environment to improve meaningfully in the third quarter for the EV maker as China is on track to fully reopen in June.",
                                    "sentiment": 0.4404,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Xpeng, which has a backer in Tesla bull Cathie Wood, on Monday said it expects to deliver between 31,000 and 34,000 electric vehicles in the second quarter.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Xpeng, he said, continues to deliver price-protected orders until late June bearing the higher raw material costs.\n\nSee Also: Why This Analyst Is Bullish On Tesla, Nio Rival Xpeng\n\n“Due to lockdowns, the deliveries of price-protected orders will likely finish in late June, thus hurting second-quarter vehicle gross margin.",
                                    "sentiment": -0.7003,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Xpeng said it plans to start delivering its first SUV model G9 in the third quarter and plans to launch two new models next year.\n\nRival Nio Inc (NYSE: NIO) is scheduled to report first-quarter numbers on June 9.\n\nPrice Action: Xpeng closed 5.5% lower at $21.9 on Monday and was trading 1.8% lower in after-hours.",
                                    "sentiment": -0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Cathie Wood-Backed Tesla Rival Xpeng Gets A 7% Lower Price Target But Why Analyst Is Still Bullish",
                                    "sentiment": -0.296,
                                    "highlighted_in": "title"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "uuid": "2c63a1a4-dd81-489e-ac6d-22dade70d9d1",
            "title": "What Snap Tells Us About Consumers as Retailers Line Up More Earnings",
            "description": "Zoom Video is facing lower demand, DiDi is set to delist in U.S. to resolve security review, drug regulators consider vaccines for young children, and other...",
            "keywords": "article_normal, Food/Beverages, Dairy Products, Textiles, Wholesalers, Retail/Wholesale, Insurance, Legal Services, Business/Consumer Services, Clothing/Textiles, Consumer Goods, Financial Services, Food Products, Online Service Providers, Media/Entertainment, Retail, Social Media Platforms/Tools, Technology, Corporate Changes, Financial Performance, Earnings, Earnings Projections, Corporate/Industrial News, Stock Delistings, Profit Warnings, Political/General News, Respiratory Tract Diseases, Health, Immunizations, Medical Conditions, Novel Coronaviruses, Infectious Diseases, Medical Treatments/Procedures, Content Types, Factiva Filters, C&E Industry News Filter, SYND, The Barron's Daily, Markets, News, Biotech and Pharma, Travel, Consumer, Cryptocurrencies, Davos, Economy & Policy, Economics, Coronavirus, DiDi Global, DIDI, Baidu, K3SD.SG, Tencent Holdings, 0700.HK, Airbnb Cl A, ABNB, BioNTech SE, BNTX, Bavarian Nordic, BAVA.KO, Microsoft, MSFT, Snap, SNAP, Meta Platforms, FB, Pinterest, PINS, GameStop Cl A, GME, Chewy Cl A, CHWY, Robinhood Markets, HOOD, Nasdaq, NDAQ, PayPal Holdings, PYPL, Macy's, M, Apple, AAPL, Target, TGT, Walmart, WMT, Alphabet Cl A, GOOGL, Twitter, TWTR, Lowe's Cos., LOW, Alibaba Group Holding, 9988.HK, Best Buy, BBY, Dick's Sporting Goods, DKS, Home Depot, HD, Moderna, MRNA, Pfizer, PFE, Zoom Video Communications, ZM, NASDAQ Composite Index, COMP, S&P 500 Index, SPX, corporate changes, financial performance, earnings, earnings projections, corporate, industrial news, stock delistings, profit warnings, political, general news, respiratory tract diseases, health, immunizations, medical conditions, novel coronaviruses, infectious diseases, medical treatments, procedures, content types, factiva filters, c&e industry news filter, the barron's daily, markets, news, technology, biotech and pharma, travel, consumer, cryptocurrencies, davos, retail, economy & policy, economics, coronavirus, food, beverages, dairy products, textiles, wholesalers, wholesale, insurance, legal services, business, consumer services, clothing, consumer goods, financial services, food products, online service providers, media, entertainment, social media platforms, tools",
            "snippet": "The profit warning from Snap yesterday isn’t just hurting other technology stocks. It’s also casting a pall over retailer earnings this week, even though on...",
            "url": "https://www.marketwatch.com/articles/things-to-know-today-51653385027",
            "image_url": "https://images.barrons.com/im-550209/social",
            "language": "en",
            "published_at": "2022-05-24T11:47:00.000000Z",
            "source": "marketwatch.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "MSFT",
                    "name": "Microsoft Corporation",
                    "exchange": "NASDAQ",
                    "exchange_long": "NASDAQ Stock Exchange",
                    "country": "us",
                    "type": "equity",
                    "industry": "Technology",
                    "match_score": 7.132683,
                    "sentiment_score": 0,
                    "highlights": [
                        {
                            "highlight": "Zoom’s competition in videoconferencing includes Microsoft Teams, which is bundling its communications tools with Office 365 and offering a less expensive version to small businesses. Zoom is moving into cloud-based telephone service, where it now has three million users, and call center software.\n\nto small businesses.",
                            "sentiment": 0,
                            "highlighted_in": "main_text"
                        }
                    ]
                }
            ],
            "similar": []
        },
        {
            "uuid": "4edad086-3a24-46a0-94fe-f05d169164fe",
            "title": "In a faceoff with Elon Musk, the SEC blinked By Reuters",
            "description": "In a faceoff with Elon Musk, the SEC blinked",
            "keywords": "",
            "snippet": "© Reuters. FILE PHOTO: Tesla CEO Elon Musk leaves Manhattan federal court after a hearing on his fraud settlement with the Securities and Exchange Commission (...",
            "url": "https://www.investing.com/news/stock-market-news/in-a-faceoff-with-elon-musk-the-sec-blinked-2829530",
            "image_url": "https://i-invdn-com.investing.com/news/LYNXNPEC4317M_L.jpg",
            "language": "en",
            "published_at": "2022-05-24T11:11:42.000000Z",
            "source": "investing.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "TSLA",
                    "name": "Tesla, Inc.",
                    "exchange": "NASDAQ",
                    "exchange_long": "NASDAQ Stock Exchange",
                    "country": "us",
                    "type": "equity",
                    "industry": "Consumer Cyclical",
                    "match_score": 18.15416,
                    "sentiment_score": -0.2679,
                    "highlights": [
                        {
                            "highlight": "FILE PHOTO: Tesla CEO Elon Musk leaves Manhattan federal court after a hearing on his fraud settlement with the Securities and Exchange Commission (SEC) in New York City, U.S., April 4, 2019.",
                            "sentiment": -0.3818,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Securities and Exchange Commission (SEC) asked the court to hold the billionaire in contempt, saying a tweet by the Tesla Inc. CEO - which forecast production at the carmaker - violated a court agreement Musk signed the previous year to have some of his communications vetted by a lawyer.",
                            "sentiment": -0.4215,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Spokespeople for Tesla and Twitter and a representative for Judge Nathan did not respond to requests for comment for this story.",
                            "sentiment": 0,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Musk's attorney, Alex Spiro, did not respond to requests for comment on the SEC's deliberations, but court records and Tesla emails show he and other lawyers for the Tesla boss dispute that Musk's tweets violated the agreement.",
                            "sentiment": -0.5927,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "The vetting process required that Musk seek pre-approval for written communications – including tweets – that contained \"or reasonably could contain\" information material to Tesla shareholders.\n\nBut the decision on whether they contained material information was left to Musk and Tesla.",
                            "sentiment": 0,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Less than six months later, on Feb. 19, 2019, Musk tweeted that Tesla would make \"around 500k\" cars that year. If unvetted, this was arguably a violation of the settlement because production figures can be market sensitive information, SEC officials said in court filings.\n\nThe SEC staff asked Tesla whether Musk had submitted the tweet for vetting.",
                            "sentiment": -0.4939,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "He had not, Tesla attorneys told the SEC. The SEC said in the court complaint that when it looked into the Feb. 2019 tweet, it found Musk had not sought pre-approval for any Tesla-related tweets since the vetting system started. Its attorney told the court, \"Mr. Musk has tweeted upward of 80 times about Tesla, and the SEC thought nothing of it.",
                            "sentiment": -0.296,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Tesla attorneys said in a court filing Musk had not sought pre-approval because he \"has not tweeted material information regarding Tesla.\"\n\n\"REASONABLENESS PANTS\"\n\nFor SEC officials, Musk's violation was clear, four of the sources told Reuters.",
                            "sentiment": -0.1531,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Each tweet prompted the SEC to contact Tesla and Musk's attorneys seeking information on whether they had been pre-approved, according to SEC correspondence sent to Tesla on the matter obtained by public records requests.\n\nMusk had not sought pre-approval; Tesla's attorneys argued in the emails to the SEC it wasn't necessary.",
                            "sentiment": -0.34,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "He found the billionaire was \"bemoaning\" the 2018 deal now that he felt Tesla was \"invincible\" [L2N2WP1WY]. A representative for the court said Liman would not comment.",
                            "sentiment": 0,
                            "highlighted_in": "main_text"
                        }
                    ]
                }
            ],
            "similar": [
                {
                    "uuid": "732c801f-9fb7-4bfb-b3ac-c39ec974b6ad",
                    "title": "Do Claims Against Musk Raise a Legal Issue for His Companies and Twitter Deal?",
                    "description": "A report saying Tesla Inc CEO Elon Musk's company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as",
                    "keywords": "",
                    "snippet": "A report saying Tesla Inc CEO Elon Musk’s company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as he e...",
                    "url": "https://www.insurancejournal.com/news/national/2022/05/24/668893.htm",
                    "image_url": "https://www.insurancejournal.com/app/uploads/2022/04/bigstock-Elon-Musk--scaled.jpg",
                    "language": "en",
                    "published_at": "2022-05-24T05:29:16.000000Z",
                    "source": "insurancejournal.com",
                    "relevance_score": null,
                    "entities": [
                        {
                            "symbol": "TSLA34.SA",
                            "name": "Tesla, Inc.",
                            "exchange": "BVMF",
                            "exchange_long": "The B3 S.A. - Brasil, Bolsa, Balcão",
                            "country": "br",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 18.667637,
                            "sentiment_score": -0.554243,
                            "highlights": [
                                {
                                    "highlight": "A report saying Tesla Inc CEO Elon Musk’s company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as he eyes a takeover of Twitter.\n\nBelow is an overview of some of the key legal questions arising from the claims, which were published on Thursday by Business Insider.",
                                    "sentiment": -0.4588,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla has faced accusations of race and sex discrimination, including a race bias class action lawsuit in California state court and a lawsuit by California’s Department of Fair Housing and Employment, which alleges widespread race discrimination.",
                                    "sentiment": -0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "At least seven women have filed sexual harassment and discrimination lawsuits against Tesla since late last year. These lawsuits are at an early stage.\n\nTesla has broadly denied wrongdoing and said it has adopted policies to prevent and punish workplace misconduct.",
                                    "sentiment": -0.8979,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla is hardly unique in facing such legal challenges; most U.S. companies with large workforces face some employment-related claims and lawsuits.\n\nSpaceX is not facing lawsuits over sexual harassment, despite several accusations that female employees have made in the media and online.",
                                    "sentiment": -0.4105,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A federal judge in April awarded $15 million to a Black Tesla factory worker who claimed he was subjected to racial slurs and racist graffiti by coworkers at a Fremont, California, factory. Tesla has sought to pause the California agency’s lawsuit, claiming it failed to conduct a proper investigation before suing.",
                                    "sentiment": -0.8225,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A California judge is expected to rule soon on Tesla’s motion to send one of the sexual harassment lawsuits against Tesla to arbitration. The judge is presiding over five similar cases, so his ruling could also affect those lawsuits.\n\nIF MUSK DID SETTLE WITH THE FLIGHT ATTENDANT, WOULD HE HAVE HAD A DUTY TO DISCLOSE IT TO SPACEX’S BOARD?",
                                    "sentiment": -0.6908,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Three 2016 SpaceX board members also served simultaneously on the board of Tesla. But they have a duty of confidentiality for information obtained as a director, so they may not have shared the information with the Tesla board. Reuters was unable to ascertain whether these board members disclosed the settlement.",
                                    "sentiment": -0.1053,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        },
                        {
                            "symbol": "TSLAD.BA",
                            "name": "TESLA INC",
                            "exchange": "BCBA",
                            "exchange_long": "Buenos Aires Stock Exchange",
                            "country": "ar",
                            "type": "equity",
                            "industry": "N/A",
                            "match_score": 18.667545,
                            "sentiment_score": -0.554243,
                            "highlights": [
                                {
                                    "highlight": "A report saying Tesla Inc CEO Elon Musk’s company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as he eyes a takeover of Twitter.\n\nBelow is an overview of some of the key legal questions arising from the claims, which were published on Thursday by Business Insider.",
                                    "sentiment": -0.4588,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla has faced accusations of race and sex discrimination, including a race bias class action lawsuit in California state court and a lawsuit by California’s Department of Fair Housing and Employment, which alleges widespread race discrimination.",
                                    "sentiment": -0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "At least seven women have filed sexual harassment and discrimination lawsuits against Tesla since late last year. These lawsuits are at an early stage.\n\nTesla has broadly denied wrongdoing and said it has adopted policies to prevent and punish workplace misconduct.",
                                    "sentiment": -0.8979,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla is hardly unique in facing such legal challenges; most U.S. companies with large workforces face some employment-related claims and lawsuits.\n\nSpaceX is not facing lawsuits over sexual harassment, despite several accusations that female employees have made in the media and online.",
                                    "sentiment": -0.4105,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A federal judge in April awarded $15 million to a Black Tesla factory worker who claimed he was subjected to racial slurs and racist graffiti by coworkers at a Fremont, California, factory. Tesla has sought to pause the California agency’s lawsuit, claiming it failed to conduct a proper investigation before suing.",
                                    "sentiment": -0.8225,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A California judge is expected to rule soon on Tesla’s motion to send one of the sexual harassment lawsuits against Tesla to arbitration. The judge is presiding over five similar cases, so his ruling could also affect those lawsuits.\n\nIF MUSK DID SETTLE WITH THE FLIGHT ATTENDANT, WOULD HE HAVE HAD A DUTY TO DISCLOSE IT TO SPACEX’S BOARD?",
                                    "sentiment": -0.6908,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Three 2016 SpaceX board members also served simultaneously on the board of Tesla. But they have a duty of confidentiality for information obtained as a director, so they may not have shared the information with the Tesla board. Reuters was unable to ascertain whether these board members disclosed the settlement.",
                                    "sentiment": -0.1053,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        },
                        {
                            "symbol": "TSLAC.BA",
                            "name": "TESLA INC",
                            "exchange": "BCBA",
                            "exchange_long": "Buenos Aires Stock Exchange",
                            "country": "ar",
                            "type": "equity",
                            "industry": "N/A",
                            "match_score": 18.667545,
                            "sentiment_score": -0.554243,
                            "highlights": [
                                {
                                    "highlight": "A report saying Tesla Inc CEO Elon Musk’s company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as he eyes a takeover of Twitter.\n\nBelow is an overview of some of the key legal questions arising from the claims, which were published on Thursday by Business Insider.",
                                    "sentiment": -0.4588,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla has faced accusations of race and sex discrimination, including a race bias class action lawsuit in California state court and a lawsuit by California’s Department of Fair Housing and Employment, which alleges widespread race discrimination.",
                                    "sentiment": -0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "At least seven women have filed sexual harassment and discrimination lawsuits against Tesla since late last year. These lawsuits are at an early stage.\n\nTesla has broadly denied wrongdoing and said it has adopted policies to prevent and punish workplace misconduct.",
                                    "sentiment": -0.8979,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla is hardly unique in facing such legal challenges; most U.S. companies with large workforces face some employment-related claims and lawsuits.\n\nSpaceX is not facing lawsuits over sexual harassment, despite several accusations that female employees have made in the media and online.",
                                    "sentiment": -0.4105,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A federal judge in April awarded $15 million to a Black Tesla factory worker who claimed he was subjected to racial slurs and racist graffiti by coworkers at a Fremont, California, factory. Tesla has sought to pause the California agency’s lawsuit, claiming it failed to conduct a proper investigation before suing.",
                                    "sentiment": -0.8225,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A California judge is expected to rule soon on Tesla’s motion to send one of the sexual harassment lawsuits against Tesla to arbitration. The judge is presiding over five similar cases, so his ruling could also affect those lawsuits.\n\nIF MUSK DID SETTLE WITH THE FLIGHT ATTENDANT, WOULD HE HAVE HAD A DUTY TO DISCLOSE IT TO SPACEX’S BOARD?",
                                    "sentiment": -0.6908,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Three 2016 SpaceX board members also served simultaneously on the board of Tesla. But they have a duty of confidentiality for information obtained as a director, so they may not have shared the information with the Tesla board. Reuters was unable to ascertain whether these board members disclosed the settlement.",
                                    "sentiment": -0.1053,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        },
                        {
                            "symbol": "TSLA",
                            "name": "Tesla, Inc.",
                            "exchange": "NASDAQ",
                            "exchange_long": "NASDAQ Stock Exchange",
                            "country": "us",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 18.66689,
                            "sentiment_score": -0.554243,
                            "highlights": [
                                {
                                    "highlight": "A report saying Tesla Inc CEO Elon Musk’s company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as he eyes a takeover of Twitter.\n\nBelow is an overview of some of the key legal questions arising from the claims, which were published on Thursday by Business Insider.",
                                    "sentiment": -0.4588,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla has faced accusations of race and sex discrimination, including a race bias class action lawsuit in California state court and a lawsuit by California’s Department of Fair Housing and Employment, which alleges widespread race discrimination.",
                                    "sentiment": -0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "At least seven women have filed sexual harassment and discrimination lawsuits against Tesla since late last year. These lawsuits are at an early stage.\n\nTesla has broadly denied wrongdoing and said it has adopted policies to prevent and punish workplace misconduct.",
                                    "sentiment": -0.8979,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla is hardly unique in facing such legal challenges; most U.S. companies with large workforces face some employment-related claims and lawsuits.\n\nSpaceX is not facing lawsuits over sexual harassment, despite several accusations that female employees have made in the media and online.",
                                    "sentiment": -0.4105,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A federal judge in April awarded $15 million to a Black Tesla factory worker who claimed he was subjected to racial slurs and racist graffiti by coworkers at a Fremont, California, factory. Tesla has sought to pause the California agency’s lawsuit, claiming it failed to conduct a proper investigation before suing.",
                                    "sentiment": -0.8225,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A California judge is expected to rule soon on Tesla’s motion to send one of the sexual harassment lawsuits against Tesla to arbitration. The judge is presiding over five similar cases, so his ruling could also affect those lawsuits.\n\nIF MUSK DID SETTLE WITH THE FLIGHT ATTENDANT, WOULD HE HAVE HAD A DUTY TO DISCLOSE IT TO SPACEX’S BOARD?",
                                    "sentiment": -0.6908,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Three 2016 SpaceX board members also served simultaneously on the board of Tesla. But they have a duty of confidentiality for information obtained as a director, so they may not have shared the information with the Tesla board. Reuters was unable to ascertain whether these board members disclosed the settlement.",
                                    "sentiment": -0.1053,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        },
                        {
                            "symbol": "TL0.DE",
                            "name": "Tesla, Inc.",
                            "exchange": "XETRA",
                            "exchange_long": "Deutsche Börse Xetra",
                            "country": "de",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 18.668365,
                            "sentiment_score": -0.554243,
                            "highlights": [
                                {
                                    "highlight": "A report saying Tesla Inc CEO Elon Musk’s company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as he eyes a takeover of Twitter.\n\nBelow is an overview of some of the key legal questions arising from the claims, which were published on Thursday by Business Insider.",
                                    "sentiment": -0.4588,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla has faced accusations of race and sex discrimination, including a race bias class action lawsuit in California state court and a lawsuit by California’s Department of Fair Housing and Employment, which alleges widespread race discrimination.",
                                    "sentiment": -0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "At least seven women have filed sexual harassment and discrimination lawsuits against Tesla since late last year. These lawsuits are at an early stage.\n\nTesla has broadly denied wrongdoing and said it has adopted policies to prevent and punish workplace misconduct.",
                                    "sentiment": -0.8979,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla is hardly unique in facing such legal challenges; most U.S. companies with large workforces face some employment-related claims and lawsuits.\n\nSpaceX is not facing lawsuits over sexual harassment, despite several accusations that female employees have made in the media and online.",
                                    "sentiment": -0.4105,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A federal judge in April awarded $15 million to a Black Tesla factory worker who claimed he was subjected to racial slurs and racist graffiti by coworkers at a Fremont, California, factory. Tesla has sought to pause the California agency’s lawsuit, claiming it failed to conduct a proper investigation before suing.",
                                    "sentiment": -0.8225,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A California judge is expected to rule soon on Tesla’s motion to send one of the sexual harassment lawsuits against Tesla to arbitration. The judge is presiding over five similar cases, so his ruling could also affect those lawsuits.\n\nIF MUSK DID SETTLE WITH THE FLIGHT ATTENDANT, WOULD HE HAVE HAD A DUTY TO DISCLOSE IT TO SPACEX’S BOARD?",
                                    "sentiment": -0.6908,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Three 2016 SpaceX board members also served simultaneously on the board of Tesla. But they have a duty of confidentiality for information obtained as a director, so they may not have shared the information with the Tesla board. Reuters was unable to ascertain whether these board members disclosed the settlement.",
                                    "sentiment": -0.1053,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        },
                        {
                            "symbol": "TSLA.MX",
                            "name": "Tesla, Inc.",
                            "exchange": "BMV",
                            "exchange_long": "Mexican Stock Exchange",
                            "country": "mx",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 18.668665,
                            "sentiment_score": -0.554243,
                            "highlights": [
                                {
                                    "highlight": "A report saying Tesla Inc CEO Elon Musk’s company SpaceX paid $250,000 to settle sexual harassment claims by a flight attendant on a private jet comes as he eyes a takeover of Twitter.\n\nBelow is an overview of some of the key legal questions arising from the claims, which were published on Thursday by Business Insider.",
                                    "sentiment": -0.4588,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla has faced accusations of race and sex discrimination, including a race bias class action lawsuit in California state court and a lawsuit by California’s Department of Fair Housing and Employment, which alleges widespread race discrimination.",
                                    "sentiment": -0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "At least seven women have filed sexual harassment and discrimination lawsuits against Tesla since late last year. These lawsuits are at an early stage.\n\nTesla has broadly denied wrongdoing and said it has adopted policies to prevent and punish workplace misconduct.",
                                    "sentiment": -0.8979,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Tesla is hardly unique in facing such legal challenges; most U.S. companies with large workforces face some employment-related claims and lawsuits.\n\nSpaceX is not facing lawsuits over sexual harassment, despite several accusations that female employees have made in the media and online.",
                                    "sentiment": -0.4105,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A federal judge in April awarded $15 million to a Black Tesla factory worker who claimed he was subjected to racial slurs and racist graffiti by coworkers at a Fremont, California, factory. Tesla has sought to pause the California agency’s lawsuit, claiming it failed to conduct a proper investigation before suing.",
                                    "sentiment": -0.8225,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "A California judge is expected to rule soon on Tesla’s motion to send one of the sexual harassment lawsuits against Tesla to arbitration. The judge is presiding over five similar cases, so his ruling could also affect those lawsuits.\n\nIF MUSK DID SETTLE WITH THE FLIGHT ATTENDANT, WOULD HE HAVE HAD A DUTY TO DISCLOSE IT TO SPACEX’S BOARD?",
                                    "sentiment": -0.6908,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Three 2016 SpaceX board members also served simultaneously on the board of Tesla. But they have a duty of confidentiality for information obtained as a director, so they may not have shared the information with the Tesla board. Reuters was unable to ascertain whether these board members disclosed the settlement.",
                                    "sentiment": -0.1053,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}
            
        

Similar News Available on: All plans

Endpoint

            
                GET https://api.marketaux.com/v1/news/similar/uuid HTTP/1.1
            
        

Use this endpoint to find similar stories to a specific article based on its UUID.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_gte false Use this to find all articles with entities with a sentiment_score of greater than or equal to x.
Example: sentiment_gte=0 - this will find all articles which are neutral or positive
sentiment_lte false Use this to find all articles with entities with a sentiment_score of less than or equal to x.
Example: sentiment_lte=0 - this will find all articles which are neutral or negative
filter_entities false By default all entities for each article are returned - by setting this to true, only the relevant entities to your query will be returned with each article. For example, if you set symbols=TSLA and filter_entities=true, only "TSLA" entities will be returned with the articles.
Default: false
must_have_entities false By default all articles are returned, set this to true to ensure that at least one entity has been identified within the article.
Default: false
group_similar false Group similar articles to avoid displaying multiple articles on the same topic/subject.
Default: true
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Find all articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_after false Find all articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-05-24
limit false Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.
page false Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2

Response Objects

name description
meta > found The number of articles found for the request.
meta > returned The number of articles returned on the page. This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page.
meta > limit The limit based on the limit parameter.
meta > page The page number based on the page parameter.
data > uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
data > title The article title.
data > description The article meta description.
data > keywords The article meta keywords.
data > snippet The first 60 characters of the article body.
data > url The URL to the article.
data > image_url The URL to the article image.
data > language The language of the source.
data > published_at The datetime the article was published.
data > source The domain of the source.
data > relevance_score Relevance score based on the article provided.
data > entities > symbol Symbol of the identified entity.
data > entities > name Name of the identified entity.
data > entities > exchange Exchange identifier of the identified entity.
data > entities > exchange_long Exchange name of the identified entity.
data > entities > country Exchange country of the identified entity.
data > entities > type Type of the identified entity.
data > entities > industry Industry of the identified entity.
data > entities > match_score The overall strength of the matching for the identified entity.
data > entities > sentiment_score Average sentiment of all highlighted text found for the identified entity.
data > entities > highlights > highlight Snippet of text from the article where the entity has been identified.
data > entities > highlights > sentiment The sentiment of the highlighed text.
data > entities > highlights > highlighted_in Where the highlight was found (title | main_text).
data > similar Array of news articles which are very similar to the main article.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
            
        

Example Response

            
                
            {
                "meta": {
                    "found": 222,
                    "returned": 3,
                    "limit": 3,
                    "page": 1
                },
                "data": [
                    {
                        "uuid": "489e4ec4-84a9-4628-966c-95c3741c6dfc",
                        "title": "Bitcoin Drops below $47K: Is BTC in a Bear Market?",
                        "description": "Bitcoin's rally seems to have made a sharp U-turn. Is this a short-lived correction or a longer-term trend?",
                        "keywords": "",
                        "snippet": "The market correction that many crypto analysts have been predicting for weeks seems to have finally arrived. Indeed, crypto markets are seeing red across the ...",
                        "url": "https://www.financemagnates.com/cryptocurrency/news/bitcoin-drops-below-47k-is-btc-in-a-bear-market/",
                        "image_url": "https://www.financemagnates.com/wp-content/uploads/2020/02/bitcoin-tightrope.jpg",
                        "language": "en",
                        "published_at": "2021-02-23T11:00:40.000000Z",
                        "source": "financemagnates.com",
                        "relevance_score": 106.05874,
                        "entities": [ ],
                        "similar": [ ]
                    },
                    {
                        "uuid": "61be555e-3120-44b0-ad13-6f985ea92f63",
                        "title": "Bitcoin ETFs vs Spot BTC",
                        "description": "Bitcoin is now the largest and most well-known cryptocurrency. This cryptocurrency has a market cap of several hundred billion dollars and as a result, has ...",
                        "keywords": "",
                        "snippet": "Bitcoin is now the largest and most well-known cryptocurrency. This cryptocurrency has a market cap of several hundred billion dollars and as a result, has mass...",
                        "url": "https://www.benzinga.com/markets/cryptocurrency/21/02/19808328/bitcoin-etfs-vs-spot-btc",
                        "image_url": "https://cdn.benzinga.com/files/imagecache/og_image_social_share_1200x630/images/story/2012/investing.jpg",
                        "language": "en",
                        "published_at": "2021-02-23T21:11:34.000000Z",
                        "source": "benzinga.com",
                        "relevance_score": 95.900276,
                        "entities": [ ],
                        "similar": [ ]
                    },
                    ...
                ]
            }
        
            
        

News by UUID Available on: All plans

Endpoint

            
                GET https://api.marketaux.com/v1/news/uuid/uuid HTTP/1.1
            
        

Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
title The article title.
description The article meta description.
keywords The article meta keywords.
snippet The first 60 characters of the article body.
url The URL to the article.
image_url The URL to the article image.
language The language of the source.
published_at The datetime the article was published.
source The domain of the source.
entities > symbol Symbol of the identified entity.
entities > name Name of the identified entity.
entities > exchange Exchange identifier of the identified entity.
entities > exchange_long Exchange name of the identified entity.
entities > country Exchange country of the identified entity.
entities > type Type of the identified entity.
entities > industry Industry of the identified entity.
entities > match_score The overall strength of the matching for the identified entity.
entities > sentiment_score Average sentiment of all highlighted text found for the identified entity.
entities > highlights > highlight Snippet of text from the article where the entity has been identified.
entities > highlights > sentiment The sentiment of the highlighed text.
entities > highlights > highlighted_in Where the highlight was found (title | main_text).

If no results are found, a resource_not_found error will be returned.

Example Request

            
                GET https://api.marketaux.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                
            {
                "uuid": "9b9fb67e-9438-4263-815e-ef6a7d36af07",
                "title": "Bitcoin (BTC/USD), Ethereum (ETH/USD) Crushed as Cryptocurrency Market is Overrun by Sellers",
                "description": "The cryptocurrency market has been experiencing wild price swings over the last two days with sellers in complete control as prices slump across the board",
                "keywords": "",
                "snippet": "Bitcoin (BTC/USD) Price, Analysis and Chart: Bullish channel is broken in a two day sell-off...",
                "url": "https://www.dailyfx.com/forex/market_alert/2021/02/23/Bitcoin-BTCUSD-Ethereum-ETHUSD-Crushed-as-Cryptocurrency-Market-is-Overrun-by-Sellers.html",
                "image_url": "https://a.c-dn.net/b/2jPuVf/headline_shutterstock_365875643.jpg",
                "language": "en",
                "published_at": "2021-02-23T10:30:00.000000Z",
                "source": "dailyfx.com",
                "entities": [
                    {
                        "symbol": "BTCUSD",
                        "name": "Bitcoin USD",
                        "exchange": "CC",
                        "exchange_long": "Cryptocurrency",
                        "country": "global",
                        "type": "cryptocurrency",
                        "industry": "N/A",
                        "match_score": 82.04055,
                        "sentiment_score": -0.177075,
                        "highlights": [
                            {
                                "highlight": "Bitcoin (BTC/USD) Price, Analysis and Chart: Bullish channel is broken in a two day sell-off. No specific driver of price action.",
                                "sentiment": -0.6486,
                                "highlighted_in": "main_text"
                            },
                            ...
                        ]
                    },
                    {
                        "symbol": "ETHUSD",
                        "name": "Ethereum USD",
                        "exchange": "CC",
                        "exchange_long": "Cryptocurrency",
                        "country": "global",
                        "type": "cryptocurrency",
                        "industry": "N/A",
                        "match_score": 65.22654,
                        "sentiment_score": -0.4215,
                        "highlights": [
                            {
                                "highlight": "Bitcoin (BTC/USD), Ethereum (ETH/USD) Crushed as Cryptocurrency Market is Overrun by Sellers",
                                "sentiment": -0.4215,
                                "highlighted_in": "title"
                            }
                        ]
                    }
                ]
            }
        
            
        

Entity Stats (time series) Available on: Standard and above

Endpoint

            
                GET https://api.marketaux.com/v1/entity/stats/intraday HTTP/1.1
            
        

Get an intraday view of how well entities performed over different intervals using this endpoint. Find the best or worst performing entities broken down to every minute, hour, day, week, month, quarter or year. Useful for comparing entities and creating graphs and charts

Adding symbols to the request is not necessary - by default all of the best performing stocks are returned. Filter entities by symbols, exchanges, industries, countries, entity types and more.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
interval false The interval of the time series.

Options: minute | hour | day | week | month | quarter | year
Default: day
Example: interval=day

Note: there are restrictions on the maximum time frame for each interval. This is based on the published_before parameter. From the published_before date specified, the maximum time frame that can be retrieved is as following:

minute = 7 days
hour = 1 month
day = 3 years
week = 5 years
month = 5 years
quarter = 10 years
year = 10 years

By default the maximum allowed time frame will be applied. If the time frame is exceeded by the date parameters provided, the default will be applied - no error will be thrown.

For example, if interval=minute and published_before=2021-01-10, the max that can be returned will be back to 2021-01-03. You can specify a published_after value to reduce this time frame if necessary (e.g. published_after=2021-01-08).
group_by false Group results by symbol | exchange | industry | country
Default: symbol
min_doc_count false The minimum number of total_documents an entity should be identified within to be returned with the results.
Example: min_doc_count=10
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_avg_gte false Use this to refine results to find all entities with an overall sentiment_avg greater than or equal to x.
Example: sentiment_avg_gte=0 - this will find all entities which are neutral or positive
sentiment_avg_lte false Use this to refine results to find all entities with an overall sentiment_avg less than or equal to x.
Example: sentiment_avg_lte=0 - this will find all entities which are neutral or negative
sentiment_gte false Use this to refine results to find all documents for entities with a sentiment_score greater than or equal to x.
Example: sentiment_gte=0 - this will find all document entities which are neutral or positive
sentiment_lte false Use this to refine results to find all documents for entities with a sentiment_score less than or equal to x.
Example: sentiment_lte=0 - this will find all document entities which are neutral or negative
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Refine results for articles before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_after false Refine results for articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_on false Refine results for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-05-24
sort false Sort by total_documents or sentiment_avg
Default: total_documents
sort_order false Sort order of the sort parameter.
Options: desc | asc
Default: desc
date_order false Ordering of the date keys.
Options: desc | asc
Default: desc
limit false Specify the number of entities you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.

Response Objects

name description
data > date Date of the time series data.
data > data > key The key based on the group_by parameter. For example, this could be symbol, exchange, industry or country.
data > data > total_documents Total number of documents identified for the key and also based on the query parameters provided.
data > data > sentiment_avg Average sentiment of the key and also based on the query parameters provided.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/entity/stats/intraday?symbols=TSLA%2CAMZN%2CMSFT&interval=day&published_after=2022-05-23T12%3A40&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        {
            "date": "2022-05-24T00:00:00.000Z",
            "data": [
                {
                    "key": "TSLA",
                    "total_documents": 25,
                    "sentiment_avg": 0.1650847204308957
                },
                {
                    "key": "AMZN",
                    "total_documents": 17,
                    "sentiment_avg": -0.043051759986316454
                },
                {
                    "key": "MSFT",
                    "total_documents": 15,
                    "sentiment_avg": 0.526599999765555
                }
            ]
        },
        {
            "date": "2022-05-23T00:00:00.000Z",
            "data": [
                {
                    "key": "MSFT",
                    "total_documents": 53,
                    "sentiment_avg": 0.28717903792858124
                },
                {
                    "key": "AMZN",
                    "total_documents": 30,
                    "sentiment_avg": 0.20691380016505717
                },
                {
                    "key": "TSLA",
                    "total_documents": 24,
                    "sentiment_avg": 0.12096183537505567
                }
            ]
        }
    ]
}
            
        

Entity Stats (aggregation) Available on: Standard and above

Endpoint

            
                GET https://api.marketaux.com/v1/entity/stats/aggregation HTTP/1.1
            
        

Similar to the entity stats time series endpoint, this returns an aggregation of entities for a single time frame, rather than being broken down by date. Useful to find the best or worst performing stocks.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
group_by false Group results by symbol | exchange | industry | country
Default: symbol
min_doc_count false The minimum number of total_documents an entity should be identified within to be returned with the results.
Example: min_doc_count=10
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_avg_gte false Use this to refine results to find all entities with an overall sentiment_avg greater than or equal to x.
Example: sentiment_avg_gte=0 - this will find all entities which are neutral or positive
sentiment_avg_lte false Use this to refine results to find all entities with an overall sentiment_avg less than or equal to x.
Example: sentiment_avg_lte=0 - this will find all entities which are neutral or negative
sentiment_gte false Use this to refine results to find all documents for entities with a sentiment_score greater than or equal to x.
Example: sentiment_gte=0 - this will find all document entities which are neutral or positive
sentiment_lte false Use this to refine results to find all documents for entities with a sentiment_score less than or equal to x.
Example: sentiment_lte=0 - this will find all document entities which are neutral or negative
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Refine results for articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_after false Refine results for articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_on false Refine results for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-05-24
sort false Sort by total_documents or sentiment_avg
Default: total_documents
sort_order false Sort order of the sort parameter.
Options: desc | asc
Default: desc
limit false Specify the number of entities you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.

Response Objects

name description
meta > returned The number of entities returned.
meta > limit The limit based on the limit parameter.
data > key The key based on the group_by parameter. For example, this could be symbol, exchange, industry or country.
data > total_documents Total number of documents identified for the key and also based on the query parameters provided.
data > sentiment_avg Average sentiment of the key and also based on the query parameters provided.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/entity/stats/aggregation?symbols=TSLA%2CAMZN%2CMSFT&published_after=2022-05-23T12%3A40&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "returned": 3,
        "limit": 100
    },
    "data": [
        {
            "key": "MSFT",
            "total_documents": 68,
            "sentiment_avg": 0.33999248539261956
        },
        {
            "key": "TSLA",
            "total_documents": 49,
            "sentiment_avg": 0.14347351142395365
        },
        {
            "key": "AMZN",
            "total_documents": 47,
            "sentiment_avg": 0.116500725216688
        }
    ]
}
            
        

Endpoint

            
                GET https://api.marketaux.com/v1/entity/trending/aggregation HTTP/1.1
            
        

Use this endpoint to identify trending entities. Filter by time frame and much more; e.g. find which stocks were trending on a specific day, within the past 24 hours, past 7 days, etc.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
group_by false Group results by symbol | exchange | industry | country
Default: symbol
min_doc_count false The minimum number of total_documents an entity should be identified within to be returned with the results.
Example: min_doc_count=10
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_avg_gte false Use this to refine results to find all entities with an overall sentiment_avg greater than or equal to x.
Example: sentiment_avg_gte=0 - this will find all entities which are neutral or positive
sentiment_avg_lte false Use this to refine results to find all entities with an overall sentiment_avg less than or equal to x.
Example: sentiment_avg_lte=0 - this will find all entities which are neutral or negative
sentiment_gte false Use this to refine results to find all documents for entities with a sentiment_score greater than or equal to x.
Example: sentiment_gte=0 - this will find all document entities which are neutral or positive
sentiment_lte false Use this to refine results to find all documents for entities with a sentiment_score less than or equal to x.
Example: sentiment_lte=0 - this will find all document entities which are neutral or negative
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Refine results for articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_after false Refine results for articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-05-24T12:40:20 | 2022-05-24T12:40 | 2022-05-24T12 | 2022-05-24 | 2022-05 | 2022
published_on false Refine results for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-05-24
sort false Sort by total_documents or sentiment_avg
Default: total_documents
sort_order false Sort order of the sort parameter.
Options: desc | asc
Default: desc
limit false Specify the number of entities you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.

Response Objects

name description
meta > returned The number of entities returned.
meta > limit The limit based on the limit parameter.
data > key The key based on the group_by parameter. For example, this could be symbol, exchange, industry or country.
data > total_documents Total number of documents identified for the key and also based on the query parameters provided.
data > sentiment_avg Average sentiment of the key and also based on the query parameters provided.
data > score The relevance score for the trending entity.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/entity/trending/aggregation?exchanges=nyse%2Cnasdaq&min_doc_count=10&published_after=2022-05-23T12%3A40&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "returned": 74,
        "limit": 100
    },
    "data": [
        {
            "key": "JPM",
            "total_documents": 268,
            "sentiment_avg": 0.35145532485764863,
            "score": 4.0787080292397695
        },
        {
            "key": "RY",
            "total_documents": 217,
            "sentiment_avg": 0.46958364982132195,
            "score": 3.447706936002395
        },
        {
            "key": "WFC",
            "total_documents": 169,
            "sentiment_avg": 0.26773224838254367,
            "score": 2.338771979694558
        },
        {
            "key": "DB",
            "total_documents": 142,
            "sentiment_avg": 0.23836924799416268,
            "score": 2.185718670646047
        },
        {
            "key": "VMW",
            "total_documents": 44,
            "sentiment_avg": 0.392231224951419,
            "score": 2.103702111440764
        },
        ...
    ]
}
            
        

Endpoint

            
                GET https://api.marketaux.com/v1/entity/search HTTP/1.1
            
        

Use this endpoint to search for all entities we support. Note that the limit is 50 for all requests.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
search false Dynamic search function to find entities.
symbols false Enter specific symbols to return.
exchanges false Filter results by specific exchanges. Comma separated list.
types false Filter results by entity types. Comma separated list.
industries false Filter results by industries. Comma separated list.
countries false Filter results by ISO 3166-1 two-letter country code of the exchange. Comma separated list.
page false Use this to paginate through the result set. Default is 1.
Example: page=2

Response Objects

name description
meta > found The number of entities found for the request.
meta > returned The number of entities returned on the page.
meta > limit The limit is 50. This currently can not be changed.
meta > page The page number based on the page parameter.
data > symbol Unique entity symbol (or ticker).
data > name Entity name.
data > type The entity type.
data > industry The entity industry.
data > exchange The exchange identifier.
data > exchange_long The exchange name.
data > country The ISO 3166-1 two-letter country code of the exchange locale. (Note: 'eu' (European Union) and 'global' are also included in our list).

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/entity/search?search=tsla&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "found": 8,
        "returned": 8,
        "limit": 50,
        "page": 1
    },
    "data": [
        {
            "symbol": "BULL-TSLA-X3S-ND.CO",
            "name": "BULL TESLA X3S ND",
            "type": "equity",
            "industry": "N/A",
            "exchange": "CPH",
            "exchange_long": "Nasdaq Copenhagen",
            "country": "dk"
        },
        {
            "symbol": "BULL-TSLA-X2-ND.CO",
            "name": "BULL TESLA X2 ND",
            "type": "equity",
            "industry": "N/A",
            "exchange": "CPH",
            "exchange_long": "Nasdaq Copenhagen",
            "country": "dk"
        },
        {
            "symbol": "BEAR-TSLA-X2-ND.CO",
            "name": "BEAR TESLA X2 ND",
            "type": "equity",
            "industry": "N/A",
            "exchange": "CPH",
            "exchange_long": "Nasdaq Copenhagen",
            "country": "dk"
        },
        {
            "symbol": "BEAR-TSLA-X1-ND.CO",
            "name": "BEAR TESLA X1 ND",
            "type": "equity",
            "industry": "N/A",
            "exchange": "CPH",
            "exchange_long": "Nasdaq Copenhagen",
            "country": "dk"
        },
        {
            "symbol": "BEAR-TSLA-X2-NN.OL",
            "name": "BEAR TESLA X2 NN",
            "type": "equity",
            "industry": "N/A",
            "exchange": "OSE",
            "exchange_long": "Oslo Stock Exchange",
            "country": "no"
        },
        ...
    ]
}
            
        

Exchange List Available on: All plans

Endpoint

            
                GET https://api.marketaux.com/v1/entity/exchange/list HTTP/1.1
            
        

Use this endpoint to return a list of all supported exchanges.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
data > exchange The unique identifier of the exchange.
data > exchange_long The name of the exchange.
data > country The ISO 3166-1 two-letter country code of the exchange locale. (Note: 'eu' (European Union) and 'global' are also included in our list).

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/entity/exchange/list?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        {
            "exchange": "NASDAQ",
            "exchange_long": "NASDAQ Stock Exchange",
            "country": "us"
        },
        {
            "exchange": "NYSE",
            "exchange_long": "New York Stock Exchange",
            "country": "us"
        },
        {
            "exchange": "DJI",
            "exchange_long": "Dow Jones Index",
            "country": "us"
        },
        {
            "exchange": "OTC",
            "exchange_long": "Over-the-counter Markets",
            "country": "us"
        },
        {
            "exchange": "NYSEARCA",
            "exchange_long": "NYSE Arca",
            "country": "us"
        },
        ...
    ]
}
            
        

Entity Type List Available on: All plans

Endpoint

            
                GET https://api.marketaux.com/v1/entity/type/list HTTP/1.1
            
        

Use this endpoint to return all supported entity types.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
data Array of entity types.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/entity/type/list?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        "equity",
        "index",
        "etf",
        "mutualfund",
        "currency",
        "cryptocurrency"
    ]
}
            
        

Industry List Available on: All plans

Endpoint

            
                GET https://api.marketaux.com/v1/entity/industry/list HTTP/1.1
            
        

Use this endpoint to return all supported entity industries.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
data Array of industries.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/entity/industry/list?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        "Technology",
        "Industrials",
        "N/A",
        "Consumer Cyclical",
        "Healthcare",
        "Communication Services",
        "Financial Services",
        "Consumer Defensive",
        "Basic Materials",
        "Real Estate",
        "Energy",
        "Utilities",
        "Financial",
        "Services",
        "Consumer Goods",
        "Industrial Goods"
    ]
}
            
        

Sources Available on: All plans

Endpoint

            
                GET https://api.marketaux.com/v1/news/sources HTTP/1.1
            
        

Use this endpoint to view sources which can be used in other API requests. Note that the limit is 50 for all requests.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
distinct_domain false Use this to group distinct domains from sources. This will make source_id null.
Example: distinct_domain=true
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
page false Use this to paginate through the result set. Default is 1.
Example: page=2

Response Objects

name description
meta > found The number of sources found for the request.
meta > returned The number of sources returned on the page.
meta > limit The limit is 50. This currently can not be changed.
meta > page The page number based on the page parameter.
data > source_id The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints. There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter.
data > domain The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints.
data > language The source language.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.marketaux.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
            
        

Example Response

            
                
            {
                "meta": {
                    "found": 5327,
                    "returned": 50,
                    "limit": 50,
                    "page": 1
                },
                "data": [
                    {
                        "source_id": "adweek.com-1",
                        "domain": "adweek.com",
                        "language": "en"
                    },
                    {
                        "source_id": "adage.com-1",
                        "domain": "adage.com",
                        "language": "en"
                    },
                    {
                        "source_id": "avc.com-1",
                        "domain": "avc.com",
                        "language": "en"
                    },
                    ...
                ]
            }
        
            
        

Errors

Errors

If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.

Errors

error code HTTP status description
malformed_parameters 400 Validation of parameters failed. The failed parameters are usually shown in the error message.
invalid_api_token 401 Invalid API token.
usage_limit_reached 402 Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header.
endpoint_access_restricted 403 Access to the endpoint is not available on your current subscription plan.
resource_not_found 404 Resource could not be found.
invalid_api_endpoint 404 API route does not exist.
rate_limit_reached 429 Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header.
server_error 500 A server error occured.
maintenance_mode 503 The service is currently under maintenance.

Example Error Response

            
                
            {
                "error": {
                    "code": "malformed_parameters",
                    "message": "The published_before parameter(s) are incorrectly formatted."
                }
            }
        
            
        

Examples

API Examples

There are unlimited ways to filter and refine your results with our API, see a few examples below to help you get started.

If you need assistance creating the perfect query, feel free to contact us.

Retrieve all articles which have entities mentioned that exist in NASDAQ or NYSE exchanges

    
        GET https://api.marketaux.com/v1/news/all?exchanges=NYSE%2CNASDAQ&api_token=YOUR_API_TOKEN
    

Retrieve all articles which have mentioned AAPL and TSLA, and filter the entities array so ONLY these are displayed with articles

    
        GET https://api.marketaux.com/v1/news/all?symbols=AAPL%2CTSLA&filter_entities=true&api_token=YOUR_API_TOKEN
    

Find all articles with positive entity sentiment in English

    
        GET https://api.marketaux.com/v1/news/all?sentiment_gte=0.1&language=en&api_token=YOUR_API_TOKEN
    

Find all articles with neutral entity sentiment in English

    
        GET https://api.marketaux.com/v1/news/all?sentiment_gte=0&sentiment_lte=0&language=en&api_token=YOUR_API_TOKEN
    

Find all articles with negative entity sentiment in English

    
        GET https://api.marketaux.com/v1/news/all?sentiment_lte=-0.1&language=en&api_token=YOUR_API_TOKEN
    

Get a day-by-day breakdown of top mentioned entities for exchanges in the US for last month (April 2022)

    
        GET https://api.marketaux.com/v1/entity/stats/intraday?interval=day&group_by=symbol&countries=us&published_after=2022-04-01T00%3A00&published_before=2022-04-30T23%3A59&api_token=YOUR_API_TOKEN
    

Get an aggregation for the top entities by sentiment yesterday (23 May 2022)

    
        GET https://api.marketaux.com/v1/entity/stats/intraday?group_by=symbol&sort=sentiment_avg&sort_order=desc&published_on=2022-05-23&api_token=YOUR_API_TOKEN
    

Code Examples

See our prepared examples below to quickly get started implementing our API into your next project.

PHP

    
        $queryString = http_build_query([
            'api_token' => 'YOUR_API_TOKEN',
            'symbols' => 'AAPL,TSLA',
            'filter_entities' => 'true',
            'limit' => 50,
        ]);

        $ch = curl_init(sprintf('%s?%s', 'https://api.marketaux.com/v1/news/all', $queryString));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        $json = curl_exec($ch);

        curl_close($ch);

        $apiResult = json_decode($json, true);

        print_r($apiResult);
    

Python

    
        # Python 3
        import http.client, urllib.parse

        conn = http.client.HTTPSConnection('api.marketaux.com')

        params = urllib.parse.urlencode({
            'api_token': 'YOUR_API_TOKEN',
            'symbols': 'AAPL,TSLA',
            'limit': 50,
            })

        conn.request('GET', '/v1/news/all?{}'.format(params))

        res = conn.getresponse()
        data = res.read()

        print(data.decode('utf-8'))
    

Go

    
        package main

        import (
            "fmt"
            "io/ioutil"
            "net/http"
            "net/url"
        )

        func main() {
            baseURL, _ := url.Parse("https://marketaux.com")

            baseURL.Path += "v1/news/all"

            params := url.Values{}
            params.Add("api_token", "YOUR_API_TOKEN")
            params.Add("symbols", "aapl,tsla")
            params.Add("search", "ipo")
            params.Add("limit", "50")

            baseURL.RawQuery = params.Encode()

            req, _ := http.NewRequest("GET", baseURL.String(), nil)

            res, _ := http.DefaultClient.Do(req)

            defer res.Body.Close()

            body, _ := ioutil.ReadAll(res.Body)

            fmt.Println(string(body))
        }
    

JavaScript

    
        var requestOptions = {
            method: 'GET'
        };

        var params = {
            api_token: 'YOUR_API_TOKEN',
            symbols: 'msft,fb',
            limit: '50'
        };

        var esc = encodeURIComponent;
        var query = Object.keys(params)
            .map(function(k) {return esc(k) + '=' + esc(params[k]);})
            .join('&');

        fetch("https://api.marketaux.com/v1/news/all?" + query, requestOptions)
          .then(response => response.text())
          .then(result => console.log(result))
          .catch(error => console.log('error', error));
    

C#

    
        var client = new RestClient("https://api.marketaux.com/v1/news/all");
        client.Timeout = -1;

        var request = new RestRequest(Method.GET);

        request.AddQueryParameter("api_token", "YOUR_API_TOKEN");
        request.AddQueryParameter("symbols", "aapl,amzn");
        request.AddQueryParameter("limit", "50");

        IRestResponse response = client.Execute(request);
        Console.WriteLine(response.Content);
    

Java

    
        OkHttpClient client = new OkHttpClient().newBuilder()
          .build();

        HttpUrl.Builder httpBuilder = HttpUrl.parse("https://api.marketaux.com/v1/news/all").newBuilder();
        httpBuilder.addQueryParameter("api_token", "YOUR_API_TOKEN");
        httpBuilder.addQueryParameter("symbols", "aapl,msft");
        httpBuilder.addQueryParameter("limit", "50");

        Request request = new Request.Builder().url(httpBuilder.build()).build();

        Response response = client.newCall(request).execute();