0.06
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Provides access to the Alchemy text mining API - http://www.alchemyapi.com/
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 0.7.0
~> 5.4.0
~> 0.10.0
~> 10.3.0
~> 0.52.1
~> 2.9.2
~> 3.3.0

Runtime

~> 0.28
~> 0.9.0
 Project Readme

AlchemyAPI

Build Status Code Climate Coverage Status Dependency Status Gem Version

This is a Ruby Client Library that provides access to the Alchemy text mining API. The current version targets the following API's:

  • Author Extraction
  • Combined Call
  • Concept Tagging
  • Emotion Analysis
  • Entity Extraction
  • Face Detection/Recognition
  • Image Scene Text Extraction
  • Image Tagging
  • Keyword Extraction
  • Language Detection
  • Relation Extraction
  • Sentiment Analysis
  • Targeted Sentiment Analysis
  • Taxonomy
  • Text Categorization
  • Text Extraction
  • Title Extraction

Not yet implemented API's:

  • Content Scraping
  • Microformats
  • RSS / ATOM

Installation

Add this line to your application's Gemfile:

gem 'alchemy-api-rb', :require => 'alchemy_api'

And then execute:

$ bundle

Or install it yourself as:

$ gem install alchemy-api-rb

Usage

You'll need to request an API Key.

Set your API Key in an initializer or something similar:

AlchemyAPI.key = "xxxxxxxxxxxxxxxxxx"

You may set the key along with other config settings:

AlchemyAPI.configure do |config|
  config.apikey = "xxxxxxxxxxxxxxxxxx"
  config.output_mode = :xml # not yet supported
end

Request keyword extraction for a string of text:

results = AlchemyAPI.search(:keyword_extraction, text: "hello world")

or

results = AlchemyAPI::KeywordExtraction.new.search(url: 'http://www.alchemyapi.com/')

or

results = AlchemyAPI::KeywordExtraction.new.search(html: "<html><body>lorem ipsum</body></html>")

Results for keyword extraction are returned as a array of keywords:

[
  {
         "text" => 'lorem ipsum',
    "relevance" => "0.993164"
  }
]

Testing

The specs are expecting your API Key as an environment variable named ALCHEMY_API_KEY. You can export it locally or prepend the test command like so:

ALCHEMY_API_KEY="this-is-my-40-character-key" bundle exec rake test

If you would like to expirement with the API you can run the console rake task and use the commands above to set the API Key issue search commands:

bundle exec rake console

TODO

  1. Add missing Alchmey API search modes
  2. Add support for raw output (JSON, XML and RDF)?

Contributing

alchemy-api-rb is work of several contributors. You're encouraged to submit pull requests, propose features and discuss issues.

See CONTRIBUTING.

License

MIT License. See LICENSE for details.