Request method is HTTP GET.
URL Structure
http://api.webhose.io/images?token=XXXXX-XXXXX&format=json&q=[QUERY]
HTTP GET Parameters
Parameter | Description | Example |
---|---|---|
q | A Boolean query containing the filters determining the images to be returned. | Find images wider than 1,000 pixels: width:>1000 |
token | Your private access token that you received when you signed up. | |
ts | The 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 |
format | The output format of the results set. It can be one of: • json (default) • xml | &format=xml |
latest | Return 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_info | Boolean parameter. If true, it will return only images that include GPS information. | &gps_info=true |
tl_lat | TopLeft latitude | &tl_lat=44.3 |
tl_lon | TopLeft longitude | &tl_lon=119.13 |
br_lat | Bottom Right latitude | &br_lat=37.71 |
br_lon | Bottom 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 Parameter | GEO Point | Example Value |
---|---|---|
tl_lat | TopLeft Latitude | 44.3 |
tl_lon | TopLeft Longitude | -119.13 |
br_lat | BottomRight Latitude | 37.71 |
br_lon | BottomRight 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