Data in machine-readable format for better decision making.
Some publications make their content available instantly while others stipulate we slightly delay content that is published on their website. The delay between publication and appearance on our site can be anywhere from milliseconds to a few minutes depending on the policy of the publication.
No, we generally do not allow redistribution of the content we provide to you. By default, you are only allowed to show the content on your website or apps to your users or clients. You can not redistribute via API or similar methods.
Please see our Terms of Service for the CityFALCON API for more clarity and legal requirements.
There are call limits based on your plan. We have per-hour limits to control usage to a reasonable level to prevent overwhelming our infrastructure, and we have monthly limits by plan level. See our plans for specifics.
We currently do not have any streaming or Websockets services, but we plan to release these features in the future.
Our sources number over 2000 publications, which we have curated specifically for financial and business content. If you cannot find a publication you want, let us know with a brief explanation. We will review the request, and, if the publication meets our standards for content and credibility, we will add it.
We do appreciate any feedback from users and by telling us about publications, you help us grow our service, too. So don’t hesitate to tell us which publications you want to see included.
Note that some publications ask to not be included in our API service, and we respect their wishes.
GET Stories call can take up to 22 parameters, such as language, domain, limit number of results, and minimum CityFALCON score. Which parameters are accessible depends on which subscription plan you choose.
The response is a list of stories, and each story is a dictionary with the Title, Description, associated NLU tags, CityFALCON score, duplicate count, source, author, and language as keys. As other analytics come online, we will extend them to the API. Exactly which keys are returned depends on your subscription as well.
See the documentation for more parameters, keys, and details.
We intend to release a personal and non-commercial use version of our API for consumers and business in the coming months. You will still need an authentication token, but it is as simple as signing up. The token will be automatically generated for you and you can start right away.
This depends on multiple factors. We are able to assist with setting up your API access and with some questions. We won’t be able to build the entire application for you, though.We are launching a consulting service for enterprises to help them implement projects from start to finish. Reach out to us if you have any interest.
Yes, you can choose the date range and look back into our archives as far as 2014, depending on your chosen plan. However, due to the volume of data, we limit the query range to one month. For example, you may search 30 Aug 2015 to 30 Sep 2015. On the other hand, 30 Aug 2015 to 15 Dec 2016 will return an error.
If you need more than 10,000 stories at once, or if you require a longer query range, consider our Historical Data Sets. These are convenient CSV files of content along with their associated analytics, and they can contain an unlimited number of instances.
Most of the content you would see as a regular user is available via the API. You'll get news stories, CityFALCON analytics, video content, and filings. Of course, some components are only available at the higher API plans.
However, Premium Content and Twitter information will require their own licenses. You will need to contact Twitter or the content provider to obtain your own licenses, and you will need to set up your own infrastructure, as we cannot relay this content via our API (even to those who have negotiated their own licenses).