1. TOP
  2. Album
  3. About Album

Distribute album data with JSON

Paid version albums can be embedded in your site with free layout and design by acquiring photo information in JSON format using the API.
JSON can be easily handled in various programming languages such as PHP, Ruby, Perl, Python, JavaScript, etc.

In order to generate an album, you need to add the url property to the photo's URL.
The value of the url property is the URL of the page on which the photo is posted.
<img src="https://photo.kinois.net/cdn.jpg?org=https://your.site.com/img/photo.jpg
&url=https://your.site.com/index.html" />

ALBUM ID

By user registration and settlement, ALBUM ID will be issued. By including the issued ALBUM ID in the path of the API, you can acquire the album and label information of the target photo.
In the following the ALBUM ID is expressed as $ album_id.

Photo API

https://photo.kinois.net/api/album/photos/$album_id.json?domain=$domain&label=$label_key If 'domain=$domain' is not specified, a list of all photos in the album is returned. If specified, returns a list of photos listed in the domain.
If 'label=$label_key' is not specified, returns a list of all the photos in the album. If specified, it will return a list of photos labeled with that label.

Acquisition of $album_id is charged. Please see the price column.

JSON

{"album":
    {"name":"$name",
        "photos":[
            {"src":"$src",
             "url":"$url",
             "created":"$created"},
            {"src":"$src2",
             "url":"$url2",
             "created":"$created2"},
             ...
         ]
     }
}
        

Callback function

When callback function is added to photo API, call callback function with JSON data as argument.

https://photo.kinois.net/api/album/photos/$album_id.json?domain=$domain&label=$label_key&callback=foo

タグAPI

https://photo.kinois.net/api/album/tags/$album_id.json?domain=$domain

JSON

{"album":
    {"name":$name,
        "tags":[
            {
                "key":"$label_key":
                "label":{"en":$en, "ja":$ja}
            }
        ]
    }
}
        
If 'domain=$domain' is not specified, a list of all labels of photos in the album is returned. If specified, returns a list of labels of photos listed in the domain.

Callback function

When callback function is added to tag API, call callback function with JSON data as argument.

https://photo.kinois.net/api/album/tags/$album_id.json?callback=foo

Sample Site

We have prepared a sample site using the album API and photo search API, so please refer to it.

Price

$5/month

There is no additional cost if you already use the image search API.

Payment method

Credit card payment only. It is an annual contract. Available credit cards are Visa, Master and Amex. The use of multiple months is a regular payment.

What to prepare

The domain will be the address of the photo. In case of https://example.com/images/photo.jpg it will be example.com.
If the photos are on example.com and example2.com, please register both. There is no maximum number of domains. You can add and delete later.

Caution

In kinois photo, violent photos and obscene pictures can not be registered as albums. Also, in order to register an album, you need to include the URL of the site where the photos are posted in the photo's address.
You can not create an album if the site is judged violent or obscene.
Be sure to create a free album before creating a paid version album.

When photos and tags are added

After rewriting the address, the picture will be added to the album at the time the page on which the picture is posted is displayed.
English tags are registered at the timing when photos are added to the album, but registration of other language tags takes about one day to two days.

Sign or sign up

Sign in with your Google Account to create or manage paid albums.
You do not need to log in to browse the album.

Sign in