Overview

With the Evri API, you can automatically, cost effectively and in a fully scalable manner: analyze text, get recommendations, discover relationships, mine facts and get popularity data.

Getting Started

To get up and running quickly, here are some great first steps:

• Check out sample API uses by visiting www.evri.com, Evri widgets, and the Evri Toolbar.
• Register as an application developer on our registration page to obtain an appId and begin making calls against the API.
• Read our REST API Reference Spec which explains our terminology, example scenarios, and the full set of calls.
• Read our JavaScript API Documentation.
• Join the discussion on our Developer Forum.
• Review our Terms of Service.
• Visit the Evri blog to review our API related blog posts.
• Read on!

Analyze text with the Evri API

Identify, categorize and locate entities in text. Extract and graph how entities are interconnected. Automatically categorize documents. Extract contextual information for subsequent media recommendations so article, image, and video recommendations are accurately tailored to the topic of a trigger document.

Identify, categorize, and locate entities

Identify people, places, and things that are present in unstructured text such as news articles, blog posts, Twitter tweets and other web content. Entities are recognized and assigned into one or more categories from our set of thousands including categories like: politician, actor, and artist. In addition to being assigned a category, returned entities have a unique identifier which allows you to look up exhaustive and complete factual information about the entity, such as birth date, films directed, songs sung, and more. Highly ambiguous entities such as Blue, Blue or Blue are accurately recognized and linked to detailed information about the specific Blue referenced in the text.

Entities can also be identified in terse, colloquial language found in Twitter tweets, Facebook status updates, or text.

Extract entity networks

Graph relationships between entities within news articles, blog posts, or text selections. Use these graphical relationships to provide additional, contextually tailored article, image, video, and tweet recommendations.

Categorize documents

Automatically categorize your documents into high level categories like politics, sports, and entertainment.

Getting started with text analysis

To get started analyzing text, see the REST spec section Get entity network about some text. Also, feel free to join our Developer Forum. Remember that before you can make any calls against the API, you’ll need to register as an application developer on our registration page.

Get recommendations with the Evri API

Get recommendations for news articles, blog posts, images, videos, Twitter tweets, quotes, and more. Articles, images, videos, or tweets can be relevant to a particular politician, actor, film, sports team, or other entity–even if the entity has a very ambiguous name like the album Ten.

Contextual media recommendations

Receive recommendations of additional content based on the context of the actual news article, blog post or text snippet a user is reading. These recommendations focus on a particular entity mentioned in the article. For example, if Barack Obama is mentioned in an article about health care, you can get health care videos focused on Barack Obama and this particular article, and not on Barack Obama in the context of Afghanistan, the economy, or some other topic.

You can also get contextual recommendations for a particular pair of entities to discover how they are related. For example, articles focused on Microsoft and Yahoo are delivered in the context of a particular trigger article.

Entity and graph driven recommendations

Get recommendations based on a person, place or thing in general–not in the context of a particular article. Given two entities, the system returns media recommendations about how they are related. For example, given the two entities Boeing 747 and United Airlines, you can find images about the two.

Getting started with recommendations

To get started with recommendations, see the REST spec section Get media about an entity. The following example scenarios from the REST specification will help as well: Get recommended articles based on text, Get recommended videos for an entity based on text, and Get recommended articles for an entity. Also, feel free to join our Developer Forum. Remember that before you can make any calls against the API, you’ll need to register as an application developer on our registration page.

Discover relationships with the Evri API

Discover how your user’s favorite actors, products, or sports organizations are related. Discover new emergent relationships that link entities to an entity right now based on the breaking news, blog and other web content.

Action relationships

Discover relationships based on the action a person, place or thing is performing, or having performed to. For example, you can find out who is criticizing Barack Obama right now, discover who is being attacked by a shark, or learn what actors are entering rehab.

Getting started with relationships

To get started exploring relationships, see the REST spec section Get relations about an entity. Also, feel free to join our Developer Forum. Remember that before you can make any calls against the API, you’ll need to register as an application developer on our registration page.

Mine facts with the Evri API

Dig through our knowledge base of facts covering millions of people, places, and things, all aggregated and normalized from information repositories including Wikipedia, Amazon, and Crunchbase.

Find highly structured factual information about an entity, such as the day a person was born, the location of a business, or the members in a band. In addition, the API makes it easy to find the common alias forms of a particular entity as mentioned in the press, such as Barack Obama, Obama, President Obama, and Barack Hussein Obama.

For example, you could use the Evri API to:

• Set up an up-to-the-minute data feed for any actor or musician who has died in the past 10 days.
• Automatically get the most popular football players over 300 pounds.
• Get all bands that are classified as heavy metal and grunge.
• Find all movies directed by Oliver Stone in the 1990s.
• Find any actor born in New Jersey who starred in a film in the 1950s.

Getting started mining facts

To get started mining facts, see the REST spec section Get information about an entity and Get entities and factual information. Also, feel free to join our Developer Forum. Remember that before you can make any calls against the API, you’ll need to register as an application developer on our registration page.

Get popularity data with the Evri API

Access data on entity popularity by category, such as politician, actor, sports person, and scientist. Popularity is determined by frequency of mentions in news articles, blog posts, and other web content, as well as user activity data.

For example, if you notice spikes in popularity for a particular entity, you can constrain recommended article searches to that day and find out why a person, place or thing suddenly became so popular.

Getting started with popularity data

To get started with popularity data, see the REST spec section Get zeitgeist information. Also, feel free to join our Developer Forum. Remember that before you can make any calls against the API, you’ll need to register as an application developer on our registration page.

The Fine Print

Before proceeding, please review our Terms of Service. By accessing or using the Evri API, you are agreeing to be bound by that agreement. If you wish to reproduce or redistribute Evri’s documentation in whole or in part, you must retain this notice and a link to the agreement.

The Evri API is currently in an early preview stage. Only a small portion of our extensive knowledgebase and NLP based text analysis and search infrastructure is currently exposed. We are committed to exposing more and more of our powerful entity web platform over time; this preview release is the first step!

Currently, Evri uses Webservius for all API monitoring, regulation, and throttling. Before you can begin making calls against the API you’ll need to register on our API registration page to get a valid appId to include in your calls.

Send Feedback!

We welcome any API feedback including ways to make the Evri API easier to use. Please use our Developer Forum to tell us about your successes and challenges. We will respond to your questions quickly.

You can also contact us at api-licensing@evri.com.