Calling the API

API endpoints are provided for performing content analysis on Internet-accessible web pages and posted HTML or text content.

REST API Endpoint

AlchemyAPI provides REST API endpoints for all text-mining and content analysis functionality.

REST endpoint URLs are defined within API documentation for named entity extraction, text categorization, relation extraction, language detection, keyword / term extraction, sentiment analysis, web page cleaning, microformats parsing, and RSS / ATOM feed detection.

API Access Key

To use AlchemyAPI, you need an access key. If you do not have an API key, you must first obtain one. Your usage of AlchemyAPI is subject to the API terms of use. Your API key should be considered confidential and not shared with anyone or embedded within any package (software, etc) that is publicly distributed.

Usage Restrictions

Usage of AlchemyAPI should abide by the restrictions of your respective API tier. Approved academic users are permitted to make a maximum of 30,000 API calls each day (or 1,000 daily calls for commercial use). More daily API calls (up to 200,000,000 daily) are available through an AlchemyAPI Subscription Plan.

Users of the AlchemyAPI Free service tier must provide proper attribution within their website or application:

• Provide a clickable hyperlink to www.alchemyapi.com within your website or application; and
• Provide attribution to AlchemyAPI within any published works that are based on or mention AlchemyAPI, or content generated by AlchemyAPI, including but not limited to research papers and journal articles.
• Provide attribution to AlchemyAPI within all web pages or documents where AlchemyAPI content and/or API results are used or displayed.

Other usage restrictions are listed in the AlchemyAPI Terms of Use policy.

SSL Encrypted Access

AlchemyAPI supports secure and encrypted access via the Secure Sockets Layer (SSL) protocol.

HTTP Compression

AlchemyAPI supports automatic compression of API responses using the gzip algorithm.

To enable compression of API response traffic, please include the following HTTP header with any API requests: