The Lateral API


Article Extractor API reference

An API to parse content in article form from a URL.



Every request must be authenticated with your subscription key. This must be sent as an HTTP header:

Subscription-Key: YOUR_API_KEY

Rate Limiting

Requests are limited to 1 per second. Information about the rate limiting is stored in the X-RateLimit-Limit and X-RateLimit-Remaining response headers.


If we have already fetched a URL in the past day, a cached copy of the object will be returned. If a day has passed since we last parsed the URL then it will be re-fetched. This should cover any issues that may arise if an article changes over time.

API Specification

  • Go
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby
  • Shell

Document Parser

Extract article/?url={url}

GET/?url={url}Extract article
Code Sample

Extract useful information from an article or blog post.

Name Example Description
url(string, required) The URL to parse

Note: the keywords, description and body fields were truncated for display purposes.

Response (200)
      "title": "Press me! The buttons that lie to you",
      "author": "Chris Baraniuk",
      "published": "2015-04-15T00:00:00.000Z",
      "url": "",
      "image": "",
      "videos": [],
      "keywords": ["control", "lie", "button", "system", "effect", "buttons", [...]],
      "description": "Does it help to push the buttons on pedestrian crossings, [...]",
      "body": "The tube pulls in to a busy station along the London Underground’s [...]"

The possible message values are:

  • url is missing, url is empty

  • Unable to parse the URL provided (when URL is not a valid format)

  • HTTP response error (when the server of the URL responds with a bad response)

  • URL responded with a XXX status code

  • Content at URL is too large

  • Content-Type XXX is not supported

Response (400)
  "message": "url is missing, url is empty"

Returned if you are requesting too frequently

Response (429)
  "message": "API rate limit exceeded"
Response (404)
  "message": "API path not found"

Server error, oops!

Response (500)
  "message": "Internal Server Error"