GET Parameters

Request method is HTTP GET.

URL Structure

http://api.webhose.io/images?token=XXXXX-XXXXX&format=json&q=[QUERY]

HTTP GET Parameters

ParameterDescriptionExample
qA Boolean query containing the filters determining the images to be returned.Find images wider than 1,000 pixels:
width:>1000
tokenYour private access token that you received when you signed up.
tsThe ts (timestamp) parameter returns results that were crawled after this timestamp (ts is a Unix timestamp in milliseconds).
Here is a Timestamp/Date converter
When not specified the default is the past 3 days.
&ts=1459835503426
formatThe output format of the results set. It can be one of:
• json (default)
• xml
&format=xml
latestReturn the latest 10 crawled images matching your query.
Use of this feature is NOT recommended as it may result in missing images.
&latest=true
gps_infoBoolean parameter. If true, it will return only images that include GPS information.&gps_info=true
tl_latTopLeft latitude&tl_lat=44.3
tl_lonTopLeft longitude&tl_lon=119.13
br_latBottom Right latitude&br_lat=37.71
br_lonBottom Right longitude&br_lon=-103.62

Geo Bounding Box Query

Searching for an image in a specific geolocated area is done by a "bounding box" with two GEO points: TopLeft & BottomRight

Example:

GET ParameterGEO PointExample Value
tl_latTopLeft Latitude44.3
tl_lonTopLeft Longitude-119.13
br_latBottomRight Latitude37.71
br_lonBottomRight Longitude-103.62

The API search is:
http://webhose.io/images?token=<TOKEN>&format=json&q=*&tl_lat=44.3&tl_lon=119.13&br_lat=37.71&br_lon=-103.62