Calling the API

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

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, language detection, keyword / term extraction, 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

Use of AlchemyAPI should abide by the restrictions of your respective service tier. AlchemyAPI Free users are permitted to make a maximum of 30,000 API calls each day.

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.

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: