searxng/searx/engines/flickr.py

91 lines
2.4 KiB
Python
Raw Normal View History

2013-10-18 00:15:26 +00:00
#!/usr/bin/env python
"""
Flickr (Images)
@website https://www.flickr.com
@provide-api yes (https://secure.flickr.com/services/api/flickr.photos.search.html)
@using-api yes
@results JSON
@stable yes
@parse url, title, thumbnail, img_src
More info on api-key : https://www.flickr.com/services/apps/create/
"""
2013-10-23 21:55:37 +00:00
from urllib import urlencode
from json import loads
2013-10-18 00:15:26 +00:00
2013-10-18 07:35:29 +00:00
categories = ['images']
2013-10-18 00:15:26 +00:00
nb_per_page = 15
paging = True
api_key = None
url = 'https://api.flickr.com/services/rest/?method=flickr.photos.search' +\
'&api_key={api_key}&{text}&sort=relevance' +\
'&extras=description%2C+owner_name%2C+url_o%2C+url_n%2C+url_z' +\
'&per_page={nb_per_page}&format=json&nojsoncallback=1&page={page}'
photo_url = 'https://www.flickr.com/photos/{userid}/{photoid}'
2014-01-20 01:31:20 +00:00
2014-01-30 00:19:51 +00:00
paging = True
def build_flickr_url(user_id, photo_id):
return photo_url.format(userid=user_id, photoid=photo_id)
2013-10-18 00:15:26 +00:00
def request(query, params):
params['url'] = url.format(text=urlencode({'text': query}),
api_key=api_key,
nb_per_page=nb_per_page,
page=params['pageno'])
2013-10-18 00:15:26 +00:00
return params
2014-01-20 01:31:20 +00:00
2013-10-18 00:15:26 +00:00
def response(resp):
results = []
search_results = loads(resp.text)
2014-05-20 14:57:03 +00:00
# return empty array if there are no results
if 'photos' not in search_results:
return []
if 'photo' not in search_results['photos']:
return []
2014-05-20 14:57:03 +00:00
photos = search_results['photos']['photo']
2014-05-20 14:57:03 +00:00
# parse results
for photo in photos:
if 'url_o' in photo:
img_src = photo['url_o']
elif 'url_z' in photo:
img_src = photo['url_z']
else:
2014-05-20 14:57:03 +00:00
continue
# For a bigger thumbnail, keep only the url_z, not the url_n
if 'url_n' in photo:
thumbnail_src = photo['url_n']
elif 'url_z' in photo:
thumbnail_src = photo['url_z']
else:
thumbnail_src = img_src
url = build_flickr_url(photo['owner'], photo['id'])
# append result
results.append({'url': url,
'title': photo['title'],
2014-05-20 14:57:03 +00:00
'img_src': img_src,
'thumbnail_src': thumbnail_src,
'content': content = photo['description']['_content'],
'author': photo['ownername'],
2014-01-20 01:31:20 +00:00
'template': 'images.html'})
# return results
2013-10-18 00:15:26 +00:00
return results