.<\/span><\/p>\n <\/p>\n
Get news with sentiment attached<\/b><\/h3>\n
Return the sentiment score alongside each story:<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/stories?access_token=YOUR_API_KEY&identifiers=AAPL_US&with_sentiment=true<\/code>
\n<\/span><\/p>\nFor finer control, get sentiment broken down by entity within each story (e.g. Apple mentioned positively within an article that also references Samsung negatively):<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/stories?access_token=YOUR_API_KEY&identifiers=AAPL_US&with_sentiments_by_entities=true<\/code><\/p>\n <\/p>\n
Get news with NLU labels attached<\/b><\/h3>\n
CityFALCON automatically tags all incoming news content via its proprietary taxonomy. These tags are available to clients, too, which is particularly useful for anyone pulling large amounts of data and who needs to index inside their own applications.<\/span><\/p>\nGet these entity-recognition labels with a single parameter:<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/stories?access_token=YOUR_API_KEY&identifiers=AAPL_US&with_nlu_labels=true<\/code><\/p>\n <\/p>\n
How to Get Sentiment Timeseries via API<\/b><\/h2>\n
The dedicated <\/span>\/services\/sentiment<\/code> endpoint returns aggregated sentiment for specific entities over a defined time period. Instead of pulling raw stories and computing sentiment yourself (expensive and technically burdensome if you do it yourself), let CityFALCON do it behind the API and pull it all at once.<\/span><\/p>\n <\/p>\n
Get sentiment for a company<\/b>
\n<\/b><\/h3>\n
GET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/services\/sentiment?access_token=YOUR_API_KEY&identifier_type=full_tickers&identifiers=AAPL_US&period=d1<\/code><\/p>\n <\/p>\n
Get sentiment for multiple entities at once<\/b><\/h3>\n
GET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/services\/sentiment?access_token=YOUR_API_KEY&identifiers=AAPL_US,MSFT_US,GOOG_US&period=h8<\/code><\/p>\nSupported time periods:<\/span><\/p>\n\nm5<\/code> \u2014 5 minutes<\/span><\/li>\nm15<\/code> \u2014 15 minutes<\/span><\/li>\nh1<\/code> \u2014 1 hour<\/span><\/li>\nh8<\/code> \u2014 8 hours<\/span><\/li>\nd1<\/code> \u2014 1 day<\/span><\/li>\nw1<\/code> \u2014 1 week<\/span><\/li>\nmth1<\/code> \u2014 1 month<\/span><\/li>\n<\/ul>\n <\/p>\n
Get sentiment for a country<\/b><\/h3>\n
GET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/services\/sentiment?access_token=YOUR_API_KEY&identifier_type=country_codes&identifiers=US,JP&period=w1<\/code><\/p>\n <\/p>\n
Include averages and statistics<\/b><\/h3>\n
GET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/services\/sentiment?access_token=YOUR_API_KEY&identifiers=AAPL_US&period=d1&average_for_period=true&statistics_for_period=true<\/code><\/p>\nThis includes story counts for each bucket (very positive, positive, etc.).<\/span><\/p>\n <\/p>\n
How to Get Investor Relations Documents via API<\/b><\/h2>\n
Investor relations content, including earnings materials, press releases, and financial statements, is retrieved from the \/<\/span>investor_relations<\/span><\/i> endpoint. IR data is critical for research and compliance, and it’s often the most useful signal for company-specific decisions.<\/span><\/p>\n <\/p>\n
Get IR documents for a company<\/b><\/h3>\n
GET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/investor_relations?access_token=YOUR_API_KEY&identifiers=AAPL_US<\/code><\/p>\n <\/p>\n
Filter IR documents by type<\/b><\/h3>\n
GET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/investor_relations?access_token=YOUR_API_KEY&identifiers=AAPL_US&type=Earnings,Press Release<\/code><\/p>\nSupported types include:<\/span><\/p>\n\n- Earnings<\/span><\/li>\n
- Press Release<\/span><\/li>\n
- Financial Statements<\/span><\/li>\n
- Others<\/span><\/li>\n<\/ul>\n
<\/p>\n
Filter IR documents by date range<\/b><\/h3>\n
Retrieve documents between two dates (YYYY-MM-DD format):<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/investor_relations?access_token=YOUR_API_KEY&identifiers=AAPL_US&start_date=2026-01-01&end_date=2026-03-31\\<\/code><\/p>\nNote: API queries are limited to the most recent 30 days. For historical analysis going further back, CityFALCON provides downloadable CSV datasets that can extend across years of coverage.<\/span><\/p>\n <\/p>\n
How to Get Insider Transactions via API<\/b><\/h2>\n
Insider transactions from corporate officers and major shareholders often provide some of the strongest early signals about a company’s trajectory. The \/insider_transactions<\/code> endpoint delivers them in structured, filtered form.<\/span><\/p>\nBeyond the basic data, there is also an informative\/uninformative switch to narrow down actionable data or generally pull compliance-related information.<\/span><\/p>\nNote: Insider tx only covers US companies and officers that are required to file the SEC Form 4.<\/span><\/i><\/p>\n <\/p>\n
Get insider transactions for a company<\/b><\/h3>\n
GET\u00a0<\/code>https:\/\/api.cityfalcon.com\/v0.2\/insider_transactions?access_token=YOUR_API_KEY&identifiers=AAPL_US<\/code><\/p>\n <\/p>\n
Filter insider transactions by type<\/b><\/h3>\n
Filter for buys and sells only:<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/insider_transactions?access_token=YOUR_API_KEY&identifiers=AAPL_US&transaction_type=buy,sell<\/code><\/p>\nSupported transaction types:<\/span><\/p>\n\n- buy<\/span><\/li>\n
- sell<\/span><\/li>\n
- gift<\/span><\/li>\n
- option exercised<\/span><\/li>\n
- other<\/span><\/li>\n<\/ul>\n
<\/p>\n
Filter for informative transactions only<\/b><\/h3>\n
Not every insider transaction is meaningful. CityFALCON flags each as informative or uninformative based on how the form has been filled out by the officer\/filer, saving you from noise like automatic vesting or programmatic option exercises:<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/insider_transactions?access_token=YOUR_API_KEY&identifiers=AAPL_US&info_type=informative<\/code><\/p>\n <\/p>\n
Filter insider transactions by date range<\/b><\/h3>\n
Insider transaction dates use UNIX timestamps:<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/insider_transactions?access_token=YOUR_API_KEY&identifiers=AAPL_US&start_date=1717200000&end_date=1719878400<\/code><\/p>\n <\/p>\n
How to Query Financial Content by DCSC Sectors<\/b><\/h2>\n
CityFALCON’s Dynamic Company Sector Classification (DCSC) system covers over 1,500 sectors across 4 levels. DCSC works across the \/stories<\/code> and \/services\/sentiment<\/code> endpoints, so you can pull news, sentiment, and relevance scores for entire sectors, not just individual tickers.<\/span><\/p>\n <\/p>\n
Get news for a DCSC sector<\/b><\/h3>\n
Retrieve stories tagged to a specific sector using the dcsc_sectors parameter on the \/stories endpoint:<\/span>
\n<\/span>
\n<\/span>GET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/stories?access_token=YOUR_API_KEY&dcsc_sectors=semiconductors&time_filter=d1<\/code><\/p>\n <\/p>\n
Refine by DCSC sector level<\/b><\/h3>\n
DCSC is a hierarchical classification. Use dcsc_sector_level to narrow the query to a specific level of granularity:<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/stories?access_token=YOUR_API_KEY&dcsc_sectors=semiconductors&dcsc_sector_level=4<\/code><\/p>\n <\/p>\n
Combine DCSC sectors with CityFALCON Score<\/b><\/h3>\n
Filter for only the most relevant sector news by combining the DCSC sector filter with a minimum relevance score:<\/span><\/p>\nGET <\/code>https:\/\/api.cityfalcon.com\/v0.2\/stories?access_token=YOUR_API_KEY&dcsc_sectors=semiconductors&min_cityfalcon_score=70&time_filter=d1<\/code><\/p>\nThis returns only high-relevance news across the entire semiconductor sector, replacing what would otherwise be dozens of individual ticker queries.<\/span><\/p>\n