Automatic Computer Vision Extraction

» For Articles, Images, Products and Front Pages

» Diffbot uses computer vision, natural language processing and machine learning to automatically recognize and structure specific page-types.

Get a Free Token

Frontpage API

The Frontpage API takes in a multifaceted “homepage” and returns individual page elements.

Test drive


To use the Frontpage API, perform a HTTP GET request on the following endpoint:

Provide the following arguments:

tokenDeveloper token
urlFrontpage URL from which to extract items (URL encoded)
Optional parameters
timeoutSpecify a value in milliseconds (e.g., &timeout=15000) to override the default API timeout of 5000ms.
formatFormat the response output in xml (default) or json
allReturns all content from page, including navigation and similar links that the Diffbot visual processing engine considers less important / non-core.
Basic authentication
To access pages that require a login/password (using basic access authentication), include the username and password in your url parameter, e.g.:

Alternatively, you can POST the content to analyze directly to the same endpoint. Specify the Content-Type header as either text/plain or text/html.


DML (Diffbot Markup Language) is an XML format for encoding the extracted structural information from the page. A DML consists of a single info section and a list of items.

Info fieldTypeDescription
idlongDMLID of the URL
titlestringExtracted title of the page
sourceURLurlthe URL this was extracted from
iconurlA link to a small icon/favicon representing the page
numItemsintThe number of items in this DML document

Some of the fields found in Items

Item fieldTypeDescription
idlongUnique hashcode/id of item
titlestringTitle of item
descriptionstringinnerHTML content of item
xrootxpathXPATH of where item was found on the page
pubDatetimestampTimestamp when item was detected on page
linkURLExtracted permalink (if applicable) of item
type{IMAGE,LINK,STORY,CHUNK}Extracted type of the item, whether the item represents an image, permalink, story (image+summary), or html chunk.
imgURLExtracted image from item
textSummarystringA plain-text summary of the item
spdouble<-[0,1]Spam score - the probability that the item is spam/ad
srdouble<-[1,5]Static rank - the quality score of the item on a 1 to 5 scale
freshdouble<-[0,1]Fresh score - the percentage of the item that has changed compared to the previous crawl