Skip to content
Gridlode
Docs · Reference

Article Extractor & Readability

GET /v1/url/readability1 credit / requestcache 60 min

Reader-mode extraction for one URL: the article's title, byline, published and modified dates, site name, language, lead image and excerpt, with the main text as clean Markdown (navigation, ads and comments removed). Adds word, sentence and paragraph counts, reading time and a Flesch reading-ease score (with the matching adaptation for German, Spanish, French, Italian, Dutch and Portuguese). Respects robots.txt by default. Failed fetches are not charged.

Query parameters

url
string · required
Public http(s) URL of the article or page.
include_links
boolean
Keep hyperlinks in the Markdown.
Default: false
include_images
boolean
Keep images in the Markdown.
Default: false
respect_robots
boolean
Refuse URLs disallowed by the site's robots.txt.
Default: true
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/url/readability?url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FWeb_scraping" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Article Extractor & Readability API page.