Semantic Text Processing API extracts named entities (people, places, brands, sports teams, music bands, movies, etc.) from any English text and classifies it into one of 14 topics: movies-tv, music, sports, games, politics, places, fashion, science-tech, culture, education, food, health, automobiles, miscellaneous. Entities roughly correspond to Wikipedia pages.

The API is optimized for colloquial English speech and is particularly useful for processing social media (tweets, FB posts), user blog/site comments, product/movie reviews, and user picture captions (e.g., Instagram or Flickr). In addition, we have successfully tested our technology on news article content and web pages often outperforming state of the art engines for web content. Extensive tests on social media posts have demonstrated over 90% precision at over 60% recall.

The API gracefully handles URLs and hashtags (e.g., #socialmedia or #sxsw). API will map most hashtags to entities and for each URL fetch its title, caption, thumbnail, and short description (usually the first 1-2 paragraphs). Semantics are automatically extracted from URL's title and description.

If you would like to process short editorial content like picture captions and titles of news articles, feel free to use the short_text mode enabled by passing the short_mode=true query parameter (by default, short_mode=false). This mode achieves higher recall for short text by applying more aggressive extraction parameters and bypassing language detection (assumed to be English). In this mode, however, URLs will not expanded and text classification into topics will be disabled.

Last 7 days, UTC

Average Latency
186ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Freemium

$0

additional fees may apply

Queries

250 / day

$0.1000 per extra

Subscribe

basic

$99.98

per month

Queries

5,000 / day

$0.0200 per extra

Subscribe

ultra

$1699.97

per month

Queries

100,000 / day

$0.0050 per extra

Subscribe
Query Authentication
 

Please visit http://dev.jetlore.com to obtain access token


Authentication
Description
Parameter
String

Jetlore API access token

access_token

Required

Endpoints

HTTP 200 : Analyzed content with links GET/text
Analyzed content with links
						{
  "textBody": {
    "text": "Jaguar is better than bmw http://bit.ly/SKNYFU",
    "entities": [
      {
        "name": "Jaguar Cars",
        "vertical": "automobiles",
        "region": {
          "start": 0,
          "end": 6
        },
        "imgUrl": "http://qwimg.s3.amazonaws.com/v1-722f4295ebaed3688c2adf63471d5af450b52a33-180x120.jpg"
      },
      {
        "name": "BMW",
        "vertical": "automobiles",
        "region": {
          "start": 22,
          "end": 25
        },
        "imgUrl": "http://qwimg.s3.amazonaws.com/v1-dfa36897d0d79626c26c3a60bbf710ce93f678ec-180x120.jpg"
      }
    ]
  },
  "media": [
    {
      "initialUrl": "http://bit.ly/SKNYFU",
      "resolvedUrl": "http://www.caradvice.com.au/199070/bmw-m5-v-mercedes-benz-e63-amg-v-jaguar-xfr-comparison-review/",
      "thumbnailUrl": "http://cdn.caradvice.com.au/wp-content/uploads/2012/11/BMW-M5-v-rivals-main-shot-625x374.jpg",
      "mediaType": "link",
      "title": {
        "text": "BMW M5 v Jaguar XFR v Mercedes-Benz E63 AMG: Comparison Review",
        "entities": [
          {
            "name": "BMW M5",
            "vertical": "automobiles",
            "region": {
              "start": 0,
              "end": 6
            },
            "imgUrl": "http://qwimg.s3.amazonaws.com/v1-ecd1772d74f189bb4115b2d8acfd55c4eaa5a50-180x120.jpg"
          },
          {
            "name": "Jaguar Cars",
            "vertical": "automobiles",
            "region": {
              "start": 9,
              "end": 15
            },
            "imgUrl": "http://qwimg.s3.amazonaws.com/v1-722f4295ebaed3688c2adf63471d5af450b52a33-180x120.jpg"
          },
          {
            "name": "Jaguar XF",
            "vertical": "automobiles",
            "region": {
              "start": 16,
              "end": 19
            },
            "imgUrl": "http://qwimg.s3.amazonaws.com/v1-a667efbb2b14795721e987b10c640106247eb1-180x120.jpg"
          },
          {
            "name": "Mercedes-Benz W211",
            "vertical": "automobiles",
            "region": {
              "start": 22,
              "end": 43
            },
            "imgUrl": "http://qwimg.s3.amazonaws.com/v1-296016dab37d6c3a4d89b1e7ddb3d9ae5eb9384-180x120.jpg"
          }
        ]
      },
      "caption": {
        "text": "www.caradvice.com.au",
        "entities": []
      },
      "description": {
        "text": "Read our BMW M5 review at CarAdvice.com.au. 2012 BMW M5 Road Test including ratings, prices, galleries and specifications.",
        "entities": [
          {
            "name": "BMW M5",
            "vertical": "automobiles",
            "region": {
              "start": 9,
              "end": 15
            },
            "imgUrl": "http://qwimg.s3.amazonaws.com/v1-ecd1772d74f189bb4115b2d8acfd55c4eaa5a50-180x120.jpg"
          },
          {
            "name": "BMW M5",
            "vertical": "automobiles",
            "region": {
              "start": 49,
              "end": 55
            },
            "imgUrl": "http://qwimg.s3.amazonaws.com/v1-ecd1772d74f189bb4115b2d8acfd55c4eaa5a50-180x120.jpg"
          }
        ]
      }
    }
  ],
  "vertical": "automobiles"
}						
Text processing

Semantic text processing, links expansion and classification


Test console
Description
Parameter
string

Text to analyze
Example: mercedes is better than audi

q

Required

boolean

This mode does not apply language detection, does not process links, does not classify text into vertical, and uses a lower threshold [this mode is useful for short editorial content].

short_text

Optional

  • missing argument – Missing mandatory argument

    HTTP 403

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like Semantic Text Processing.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.