Chat
Chat
POST https://api.finalle.ai/chat
Free chat with our real-time updated database.
Request Body
Name
Type
Description
api_key*
String
Your API key
question*
String
The current query to be processed by the chat.
The question string length must be less than 14,500 characters.
conversation_id
String
An identifier for the conversation.
If not provided, a new conversation will begin and the response will include the generatedconversation_id.
If provided, it should be a valid string corresponding to a previously returned conversation_id.
On success, returns the answer to the question received, the conversation ID (either newly generated or previously returned ID), and the related resources used to answer that question (maximum of 10 sources), with the following structure:
{
"data": {
"answer": "string", // The answer to the question asked.
"conversation_id": "string" // The unique ID for the current conversation. If a new conversation started, this will be a newly generated ID; otherwise, it will match the provided ID.
"related_sources": "list", // A list (with length <= 10) of resources found related to answer the question. Each resource is a json with structure as resources under events in the /events endpoint above.
},
"request_id": "YOUR_REQUEST_ID",
"result": "success"
}Example
For a POST request to the chat endpoint: https://api.finalle.ai/chat
With the following body using Content-Type=application/json:
{
"question": "What are the latest news regarding Apple?",
"api_key": "YOUR_API_KEY"
}The output is:
{
"data": {
"answer": "Here are the latest news regarding Apple (AAPL):\n\n1. **May 27, 2024**: Apple focuses on a pragmatic AI strategy, planning to integrate new features within core apps like Safari, Photos, Notes, and Siri. (Gadgets 360)\n2. **May 26, 2024**: Apple announces price cuts in China, an upgraded AirTag with a better chip, and faces a DOJ antitrust case. (Various sources)\n3. **May 26, 2024**: Apple is expected to unveil its AI strategy and features at the upcoming WWDC. (Mark Gurman)\n4. **May 25, 2024**: Rumors suggest iOS 18 will bring significant changes to iPhones. (CNET)\n5. **May 21, 2024**: Addigy extends one-click Apple device security with real-time compliance benchmarks for iOS, iPadOS, and macOS devices. (Addigy)\n\nFor more detailed updates, you may want to check the respective news sources.",
"conversation_id": "YOUR_GENERATED_CONVERSATION_ID",
"related_sources": [
{
"author": "Benzinga",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434076925x148932256262492200/image_Benzinga.png",
"sentiment": 4,
"significancy": 6,
"source": "news",
"source_image_url": "",
"text": "Apple made headlines with innovative accessibility features, labor strikes, and potential partnerships. Stay updated with a quick roundup of top stories.",
"ticker": "AAPL",
"timestamp": "2024-05-19T12:00:37.513105",
"title": "Apple's Eye-Controlled iPhones, Siri's Upgrade And More: A Recap Of Week's Top Stories In Appleverse - Ap",
"url": "https://www.benzinga.com/news/24/05/38909279/apples-eye-controlled-iphones-siris-upgrade-and-more-a-recap-of-weeks-top-stories-in-appleverse"
},
{
"author": "The Hindu",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435464461x961618778683669400/image_The_Hindu.png",
"sentiment": 4,
"significancy": 8,
"source": "news",
"source_image_url": "",
"text": "Apple is developing a slimmer version of the iPhone that is likely to be launched by 2025, per the Information outlet.",
"ticker": "AAPL",
"timestamp": "2024-05-18T02:47:00",
"title": "Apple set to release slimmer iPhone in 2025: Report - The Hindu",
"url": "https://www.thehindu.com/sci-tech/technology/apple-set-to-release-slimmer-iphone-in-2025-report/article68189262.ece"
},
{
"author": "Times Now",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435602258x648203228788374800/image_Times_Now.png",
"sentiment": 2,
"significancy": 8,
"source": "news",
"source_image_url": "",
"text": "The project, code-named D23, is still in the testing phase, with Apple experimenting with different designs. , Technology & Science News - Times Now",
"ticker": "AAPL",
"timestamp": "2024-05-18T05:31:42",
"title": "Apple Is Reportedly Working On A Slimmer iPhone, Launch Expected in 2025 - Times Now",
"url": "https://www.timesnownews.com/technology-science/apple-is-reportedly-working-on-a-slimmer-iphone-launch-expected-in-2025-article-110224172"
},
{
"author": "Times Now",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435602258x648203228788374800/image_Times_Now.png",
"sentiment": 4,
"significancy": 7,
"source": "news",
"source_image_url": "",
"text": "This event is highly anticipated, as the company is expected to unveil significant updates for its upcoming flagship products, including the next-generation iOS update—iOS 18., Technology & Science News - Times Now",
"ticker": "AAPL",
"timestamp": "2024-05-18T09:15:26",
"title": "Apple WWDC 24 News: iOS 18 Tipped To Arrive With Eye Tracking Feature Straight From Apple Vision Pro - Times Now",
"url": "https://www.timesnownews.com/technology-science/apple-wwdc-24-news-ios-18-tipped-to-arrive-with-eye-tracking-feature-straight-from-apple-vision-pro-article-110229274"
},
{
"author": "CNET",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434908916x448652775717659260/image_CNET.png",
"sentiment": 3,
"significancy": 5,
"source": "news",
"source_image_url": "",
"text": "Here are all the biggest rumors and leaks surrounding Apple's next major update to your iPhone.",
"ticker": "AAPL",
"timestamp": "2024-05-25T13:00:00",
"title": "It's Rumored That iOS 18 Will Change Your iPhone in Big Ways. Here's How - CNET",
"url": "https://www.cnet.com/tech/mobile/its-rumored-that-ios-18-will-change-your-iphone-in-big-ways-heres-how/"
},
{
"author": "TechSpot",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435134214x214046416932828900/image_TechSpot.png",
"sentiment": 1,
"significancy": 9,
"source": "news",
"source_image_url": "",
"text": "Apple is working on a slimmed down version of the iPhone, according to a report in The Information, which cited three people that have direct knowledge of...",
"ticker": "AAPL",
"timestamp": "2024-05-19T14:41:00",
"title": "A thinner, more expensive iPhone may be joining Apple's lineup - TechSpot",
"url": "https://www.techspot.com/news/103059-thinner-more-expensive-iphone-may-joining-apple-lineup.html"
},
{
"author": "MacDailyNews",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434894529x697246597650502640/image_MacDailyNews.png",
"sentiment": 1,
"significancy": 7,
"source": "news",
"source_image_url": "",
"text": "Apple is facing a reckoning of its own making.The Cupertino, California company has fumbled so many times in the last year…",
"ticker": "AAPL",
"timestamp": "2024-05-20T15:13:55",
"title": "There’s one way to save Apple from irrelevance: New leadership - MacDailyNews",
"url": "https://macdailynews.com/2024/05/20/theres-one-way-to-save-apple-from-irrelevance-new-leadership/"
},
{
"author": "StreetInsider",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434070800x818631823841020800/image_StreetInsider.png",
"sentiment": 5,
"significancy": 9,
"source": "news",
"source_image_url": "",
"text": "(Reuters) - Apple is developing a slimmer version of the iPhone that is likely to be launched by 2025, the Information reported on Friday, citing three...",
"ticker": "AAPL",
"timestamp": "2024-05-17T18:07:33.780455",
"title": "Apple set to release slimmer iPhone in 2025, the Information reports",
"url": "https://www.streetinsider.com/Reuters/Apple+set+to+release+slimmer+iPhone+in+2025%2C+the+Information+reports/23245271.html"
},
{
"author": "MacDailyNews",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434894529x697246597650502640/image_MacDailyNews.png",
"sentiment": 4,
"significancy": 8,
"source": "news",
"source_image_url": "",
"text": "Apple is set to release AI-enabled Eye Tracking on the iPhone and iPad as part of a new range of accessibility tools announced…",
"ticker": "AAPL",
"timestamp": "2024-05-16T14:28:51",
"title": "Apple brings AI-powered eye tracking to iPhone and iPad - MacDailyNews",
"url": "https://macdailynews.com/2024/05/16/apple-brings-ai-powered-eye-tracking-to-iphone-and-ipad/"
},
{
"author": "Business Wire",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434214687x158223072648244770/image_Business_Wire.png",
"sentiment": 4,
"significancy": 6,
"source": "news",
"source_image_url": "",
"text": "Addigy Extends One-Click Apple Device Security with the Only Real-time Compliance Benchmarks for iOS, iPadOS and macOS Devices. 05/21/2024 - 09:10 AM.",
"ticker": "AAPL",
"timestamp": "2024-05-21T14:01:44.952375",
"title": "All News",
"url": "https://www.businesswire.com/portal/site/home/template.PAGE/news/?javax.portlet.tpst=ccf123a93466ea4c882a06a9149550fd&javax.portlet.prp_ccf123a93466ea4c882a06a9149550fd_viewID=MY_PORTAL_VIEW&javax.portlet.prp_ccf123a93466ea4c882a06a9149550fd_ndmHsc=v2*A1713697200000*B1716299962104*DgroupByDate*G3*N1000003&javax.portlet.begCacheTok=com.vignette.cachetoken&javax.portlet.endCacheTok=com.vignette.cachetoken"
}
]
},
"request_id": "YOUR_REQUEST_ID",
"result": "success"
}Invalid values were supplied for the API request.
Example
For a POST request to the chat URL: https://api.finalle.ai/chat
With the following body (Content-Type is application/json):
The output will have 400 response status code with the following response:
Something went wrong on our server.
The output will have 500 response status code with the following response:
Last updated