GeoStockPhoto allows Registered User to interact with the Site from outside via API.

In particular, the Registered User shall have the right to reproduce on its website and/or application the following information that can be found on the Site:

  • Photos in a reduced size, with maximum side size of 120 pixel;
  • Photos in a reduced size, with maximum side size of 430 pixel with the GeoStockPhoto watermark;
  • Circular thumbnails of the Photos, as shown on the map of the Site;
  • All information relating to the Photos, including but not limited to, geographic location, title, category, and description of the Photos.

It is understood that the Registered User who makes any reproduction under this article shall be obliged to include (a) the reference to GeoStockPhoto as the source of the reproduced data and (b) the link to the page of the Site on each of the Photos concerned.

Remains also understood that the Registered User shall refrain from making reproductions pursuant to this article in violation of any rights of third parties and/or contexts, defamatory, libelous, obscene, indecent or otherwise illegal.

The Registered User acknowledges and agrees to be responsible, and agrees to hold harmless and indemnify GeoStockPhoto, from and against any liability and/or costs which may arise from reproductions made in a manner contrary to the provisions of this article and/or the law.

Last 7 days, UTC

Average Latency
184ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
Query Authentication
 

A new API Key must be requested by every user at the following link http://www.geostockphoto.com/site/api


Authentication
Description
Parameter
String

A new API Key must be requested by every user at the following link http://www.geostockphoto.com/site/api

apiKey

Required

Endpoints

HTTP 200 : photo/getConfCategory Model GET/photo/getConfCategory
						{
  "category": [
    {
      "idCategory": 1,
      "name": "Animals"
    },
    {
      "idCategory": 2,
      "name": "Arts"
    },
    {
      "idCategory": 3,
      "name": "Buildings"
    },
    {
      "idCategory": 4,
      "name": "Celebrities"
    },
    {
      "idCategory": 5,
      "name": "Editorial"
    },
    {
      "idCategory": 6,
      "name": "Fashion"
    },
    {
      "idCategory": 7,
      "name": "Food/Drink"
    },
    {
      "idCategory": 8,
      "name": "Holidays"
    },
    {
      "idCategory": 9,
      "name": "Interiors"
    },
    {
      "idCategory": 10,
      "name": "Landscape"
    },
    {
      "idCategory": 11,
      "name": "Nature"
    },
    {
      "idCategory": 12,
      "name": "Objects"
    },
    {
      "idCategory": 13,
      "name": "People"
    },
    {
      "idCategory": 14,
      "name": "Religion"
    },
    {
      "idCategory": 15,
      "name": "Signs/Symbols"
    },
    {
      "idCategory": 16,
      "name": "Sports/Recreations"
    },
    {
      "idCategory": 17,
      "name": "Technology"
    },
    {
      "idCategory": 18,
      "name": "Transportation"
    },
    {
      "idCategory": 19,
      "name": "Other"
    },
    {
      "idCategory": 29,
      "name": "Heritage"
    },
    {
      "idCategory": 30,
      "name": "Science"
    },
    {
      "idCategory": 31,
      "name": "Music"
    },
    {
      "idCategory": 32,
      "name": "Macro"
    },
    {
      "idCategory": 33,
      "name": "Work"
    }
  ]
}						
photo/getConfCategory

Returns the list of all categories that any photo can have on GeoStockPhoto.


HTTP 200 : photo/getConfSize Model GET/photo/getConfSize
						{
  "size": [
    {
      "idSize": 2,
      "code": "XS",
      "maxSize": 430
    },
    {
      "idSize": 3,
      "code": "S",
      "maxSize": 1000
    },
    {
      "idSize": 4,
      "code": "M",
      "maxSize": 3000
    },
    {
      "idSize": 5,
      "code": "L",
      "maxSize": 6000
    },
    {
      "idSize": 6,
      "code": "XL",
      "maxSize": 15000
    }
  ]
}						
photo/getConfSize

Returns the list of all sizes that any photo can have on GeoStockPhoto.


HTTP 200 : photo/getInfo Model GET/photo/getInfo
						{
  "idUser": 5,
  "title": "Trapani, Sicily",
  "description": "",
  "lng": 12.493955,
  "lat": 38.015936,
  "idCategory1": 10,
  "rate": 3,
  "approvedDate": "27/Sep/2012 - 10:12"
}						
photo/getInfo

Returns the descriptive information of a photo.


Test console
Description
Parameter
string

Unique ID of the photo.
Example: 1

id

Required

HTTP 200 : photo/getSearch Model GET/photo/getSearch
						{
  "errCode": 1
}						
photo/getSearch

Returns the photos available for sales with full search capabilities.


Test console
Description
Parameter
number

Search by category of the photos. You can retrieve the possible categories by using the method getConfCategory.
Example: 1

idCategory

Optional

number

Search by minimum dimension of the photos. You can retrieve the possilbe dimensions by using the method getConfSize.
Example: 1

idSize

Optional

number

Latitude of the North-East corner of the geographical region you want to search the photos.
Example: 85

lat_NE

Optional

number

Latitude of the South-West corner of the geographical region you want to search the photos.
Example: -85

lat_SW

Optional

number

Maximum number of returned photos.
Example: 100

limit

Optional

number

Longitude of the North-East corner of the geographical region you want to search the photos.
Example: 180

lng_NE

Optional

number

Longitude of the South-West corner of the geographical region you want to search the photos.
Example: -180

lng_SW

Optional

number

Search by minimum rate of the photos.
Example: 1

rate

Optional

string

3 options: '120', '430' or 'circle' in order to get the source of the 120px, 430px or the circle thumb.

thumb

Optional

string

Search by author of the photos.

user

Optional

Consume this API completely for free!


By joining the mashape API marketplace you can start using GeoStockPhoto API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.