Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://api.flickr.com/services
/upload
Uploads a new photo to Flickr
{
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/PublicUploadPhotoRequest"
}
}
},
"required": true
}
POST /upload
Album
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"farm": {
"type": "string"
},
"title": {
"type": "string"
},
"photos": {
"type": "number"
},
"secret": {
"type": "string"
},
"server": {
"type": "string"
},
"videos": {
"type": "number"
},
"primary": {
"type": "string"
},
"can_comment": {
"type": "boolean"
},
"count_views": {
"type": "number"
},
"date_create": {
"type": "number"
},
"date_update": {
"type": "number"
},
"description": {
"type": "string"
},
"count_comments": {
"type": "number"
}
}
}
ContextPhoto
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"farm": {
"type": "string"
},
"safe": {
"type": "boolean"
},
"media": {
"type": "string"
},
"owner": {
"type": "string"
},
"thumb": {
"type": "string"
},
"title": {
"type": "string"
},
"secret": {
"type": "string"
},
"server": {
"type": "string"
},
"license": {
"type": "integer"
},
"is_faved": {
"type": "boolean"
}
}
}
ContextPhotos
{
"type": "object",
"properties": {
"photos": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ContextPhoto"
}
}
}
}
Cover
{
"type": "object",
"properties": {
"y": {
"type": "string"
},
"id": {
"type": "string"
},
"farm": {
"type": "string"
},
"owner": {
"type": "string"
},
"title": {
"type": "string"
},
"secret": {
"type": "string"
},
"server": {
"type": "string"
},
"isfamily": {
"type": "boolean"
},
"isfriend": {
"type": "boolean"
},
"ispublic": {
"type": "boolean"
}
}
}
Group
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"blast": {
"type": "object",
"properties": {
"user_id": {
"type": "string"
},
"_content": {
"type": "string"
},
"date_blast_added": {
"type": "string"
}
}
},
"cover": {
"$ref": "#/components/schemas/Cover"
},
"roles": {
"type": "object",
"properties": {
"admin": {
"type": "string"
},
"member": {
"type": "string"
},
"moderator": {
"type": "string"
}
}
},
"rules": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"members": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"privacy": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"iconfarm": {
"type": "string"
},
"is_admin": {
"type": "boolean"
},
"throttle": {
"type": "object",
"properties": {
"mode": {
"type": "string"
},
"count": {
"type": "integer"
},
"remaining": {
"type": "string"
}
}
},
"is_member": {
"type": "boolean"
},
"pool_rows": {
"type": "integer"
},
"iconserver": {
"type": "string"
},
"path_alias": {
"type": "string"
},
"pool_count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"description": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"topic_count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"is_moderator": {
"type": "boolean"
},
"restrictions": {
"type": "object",
"properties": {
"art_ok": {
"type": "boolean"
},
"has_geo": {
"type": "boolean"
},
"safe_ok": {
"type": "boolean"
},
"images_ok": {
"type": "boolean"
},
"photos_ok": {
"type": "boolean"
},
"videos_ok": {
"type": "boolean"
},
"screens_ok": {
"type": "boolean"
},
"moderate_ok": {
"type": "boolean"
},
"restricted_ok": {
"type": "boolean"
}
}
},
"coverphoto_url": {
"$ref": "#/components/schemas/PhotoURLs"
},
"coverphoto_farm": {
"type": "string"
},
"ispoolmoderated": {
"type": "boolean"
},
"coverphoto_server": {
"type": "string"
}
}
}
Note
{
"type": "object",
"properties": {
"description": {
"type": "string"
}
}
}
Owner
{
"type": "object",
"properties": {
"nsid": {
"type": "string"
},
"ispro": {
"type": "boolean"
},
"iconfarm": {
"type": "string"
},
"location": {
"type": "string"
},
"realname": {
"type": "string"
},
"username": {
"type": "string"
},
"iconserver": {
"type": "string"
},
"is_ad_free": {
"type": "boolean"
},
"path_alias": {
"type": "string"
},
"noindexfollow": {
"type": "boolean"
}
}
}
Person
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"nsid": {
"type": "string"
},
"cover": {
"$ref": "#/components/schemas/Cover"
},
"ispro": {
"type": "boolean"
},
"yintl": {
"type": "string"
},
"expire": {
"type": "boolean"
},
"photos": {
"type": "object",
"properties": {
"count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"views": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"firstdate": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"firstdatetaken": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
}
}
},
"iconfarm": {
"type": "string"
},
"location": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"realname": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"timezone": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"offset": {
"type": "string"
},
"timezone_id": {
"type": "string"
}
}
},
"username": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"has_stats": {
"type": "boolean"
},
"mobileurl": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"photosurl": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"coverphoto": {
"$ref": "#/components/schemas/PhotoURLs"
},
"iconserver": {
"type": "string"
},
"is_ad_free": {
"type": "boolean"
},
"path_alias": {
"type": "string"
},
"profileurl": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"can_buy_pro": {
"type": "boolean"
},
"description": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"user_secret": {
"type": "string"
},
"mbox_sha1sum": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"coverphoto_farm": {
"type": "string"
},
"unread_messages": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"coverphoto_server": {
"type": "string"
},
"disable_keyboard_shortcuts": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
}
}
}
Photo
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"farm": {
"type": "string"
},
"safe": {
"type": "boolean"
},
"tags": {
"type": "object",
"properties": {
"tag": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Tag"
}
}
}
},
"urls": {
"type": "object",
"properties": {
"url": {
"type": "array",
"items": {
"$ref": "#/components/schemas/URL"
}
}
}
},
"dates": {
"type": "object",
"properties": {
"taken": {
"type": "string"
},
"posted": {
"type": "string"
},
"lastupdate": {
"type": "string"
},
"takenunknown": {
"type": "boolean"
},
"takengranularity": {
"type": "string"
}
}
},
"media": {
"type": "string"
},
"notes": {
"type": "object",
"properties": {
"note": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Note"
}
}
}
},
"owner": {
"$ref": "#/components/schemas/Owner"
},
"title": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"usage": {
"type": "object",
"properties": {
"canblog": {
"type": "boolean"
},
"canprint": {
"type": "boolean"
},
"canshare": {
"type": "boolean"
},
"candownload": {
"type": "boolean"
}
}
},
"views": {
"type": "string"
},
"people": {
"type": "object",
"properties": {
"haspeople": {
"type": "boolean"
}
}
},
"secret": {
"type": "string"
},
"server": {
"type": "string"
},
"license": {
"type": "string"
},
"comments": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"rotation": {
"type": "string"
},
"isfavorite": {
"type": "boolean"
},
"visibility": {
"type": "object",
"properties": {
"isfamily": {
"type": "boolean"
},
"isfriend": {
"type": "boolean"
},
"ispublic": {
"type": "boolean"
}
}
},
"description": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"editability": {
"type": "object",
"properties": {
"canaddmeta": {
"type": "boolean"
},
"cancomment": {
"type": "boolean"
}
}
},
"permissions": {
"type": "object",
"properties": {
"permaddmeta": {
"type": "string"
},
"permcomment": {
"type": "string"
}
}
},
"dateuploaded": {
"type": "string"
},
"safety_level": {
"type": "string"
},
"originalsecret": {
"type": "string"
},
"publiceditability": {
"type": "object",
"properties": {
"canaddmeta": {
"type": "boolean"
},
"cancomment": {
"type": "boolean"
}
}
}
}
}
PhotoURLs
{
"type": "object",
"properties": {
"h": {
"type": "string"
},
"l": {
"type": "string"
},
"s": {
"type": "string"
},
"t": {
"type": "string"
}
}
}
PublicFlickrGroupsPoolsGetContextResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"nextphoto": {
"$ref": "#/components/schemas/ContextPhoto"
},
"prevphoto": {
"$ref": "#/components/schemas/ContextPhoto"
}
}
}
PublicGetAccessTokenResponse
{
"type": "string"
}
PublicGetAlbumPhotosResponse
{
"type": "object",
"properties": {
"photoset": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Photo"
}
}
}
}
PublicGetFavoritePhotosResponse
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"pages": {
"type": "number"
},
"total": {
"type": "number"
},
"photos": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Photo"
}
},
"perpage": {
"type": "number"
}
}
}
PublicGetFavoritesContextResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"nextphoto": {
"$ref": "#/components/schemas/ContextPhoto"
},
"prevphoto": {
"$ref": "#/components/schemas/ContextPhoto"
}
}
}
PublicGetFlickrTestEchoResponse
{
"type": "object",
"properties": {
"echo": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
}
}
}
PublicGetGalleryPhotosResponse
{
"type": "object",
"properties": {
"photos": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Photo"
}
}
}
}
PublicGetGroupDiscussionTopicsResponse
{
"type": "object",
"properties": {
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"page": {
"type": "number"
},
"pages": {
"type": "number"
},
"total": {
"type": "number"
},
"topics": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Topic"
}
},
"members": {
"type": "number"
},
"privacy": {
"type": "number"
},
"iconfarm": {
"type": "number"
},
"per_page": {
"type": "number"
},
"iconserver": {
"type": "number"
},
"ispoolmoderated": {
"type": "boolean"
}
}
}
PublicGetGroupInfoResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"group": {
"$ref": "#/components/schemas/Group"
}
}
}
PublicGetGroupPoolPhotosResponse
{
"type": "object",
"properties": {
"photos": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Photo"
}
}
}
}
PublicGetGroupTopicInfoResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"topic": {
"$ref": "#/components/schemas/Topic"
}
}
}
PublicGetGroupTopicRepliesInfoResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"reply": {
"$ref": "#/components/schemas/TopicReply"
}
}
}
PublicGetOAuthTokenResponse
{
"type": "string"
}
PublicGetPersonInformationResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"person": {
"$ref": "#/components/schemas/Person"
}
}
}
PublicGetPhotoExifResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"photo": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"exif": {
"type": "array",
"items": {
"type": "object",
"properties": {
"raw": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"tag": {
"type": "string"
},
"label": {
"type": "string"
},
"tagspace": {
"type": "string"
},
"tagspaceid": {
"type": "string"
}
}
}
},
"farm": {
"type": "string"
},
"camera": {
"type": "string"
},
"secret": {
"type": "string"
},
"server": {
"type": "string"
}
}
}
}
}
PublicGetPhotoInfoResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"photo": {
"$ref": "#/components/schemas/Photo"
}
}
}
PublicGetPhotoLicensesResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"licenses": {
"type": "object",
"properties": {
"license": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
}
}
}
PublicGetPhotoListContextResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"nextphoto": {
"$ref": "#/components/schemas/ContextPhoto"
},
"prevphoto": {
"$ref": "#/components/schemas/ContextPhoto"
}
}
}
PublicGetPhotoSetContextResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"nextphoto": {
"$ref": "#/components/schemas/ContextPhoto"
},
"prevphoto": {
"$ref": "#/components/schemas/ContextPhoto"
}
}
}
PublicGetPhotoSizesResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"sizes": {
"type": "object",
"properties": {
"sizes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Size"
}
},
"canblog": {
"type": "number"
},
"canprint": {
"type": "number"
},
"candownload": {
"type": "number"
}
}
}
}
}
PublicGetPhotostreamContextResponse
{
"type": "object",
"properties": {
"stat": {
"$ref": "#/components/schemas/Stat"
},
"count": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"nextphoto": {
"$ref": "#/components/schemas/ContextPhoto"
},
"prevphoto": {
"$ref": "#/components/schemas/ContextPhoto"
}
}
}
PublicGetUserAlbumsResponse
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"pages": {
"type": "number"
},
"total": {
"type": "number"
},
"perpage": {
"type": "number"
},
"photosets": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Album"
}
}
}
}
PublicGetUserPhotosResponse
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"pages": {
"type": "number"
},
"total": {
"type": "number"
},
"photos": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Photo"
}
},
"perpage": {
"type": "number"
}
}
}
PublicSearchPhotosResponse
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"pages": {
"type": "number"
},
"total": {
"type": "number"
},
"photos": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Photo"
}
},
"perpage": {
"type": "number"
}
}
}
PublicUploadPhotoRequest
{
"type": "object",
"required": [
"api_key",
"photo"
],
"properties": {
"tags": {
"type": "string"
},
"photo": {
"type": "string",
"format": "binary"
},
"title": {
"type": "string"
},
"hidden": {
"enum": [
"1",
"2"
],
"type": "string"
},
"api_key": {
"type": "string"
},
"is_family": {
"enum": [
"0",
"1"
],
"type": "string"
},
"is_friend": {
"enum": [
"0",
"1"
],
"type": "string"
},
"is_public": {
"enum": [
"0",
"1"
],
"type": "string"
},
"description": {
"type": "string"
},
"content_type": {
"enum": [
"1",
"2",
"3"
],
"type": "string"
},
"safety_level": {
"enum": [
"1",
"2",
"3"
],
"type": "string"
}
}
}
PublicUploadPhotoResponse
{
"type": "object",
"example": {},
"properties": {}
}
Size
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"label": {
"type": "string"
},
"media": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"source": {
"type": "string"
}
}
}
Stat
{
"type": "string"
}
Tag
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"raw": {
"type": "string"
},
"author": {
"type": "string"
},
"_content": {
"type": "string"
},
"authorname": {
"type": "string"
},
"machine_tag": {
"type": "boolean"
}
}
}
Topic
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"role": {
"type": "string"
},
"author": {
"type": "string"
},
"is_pro": {
"type": "boolean"
},
"message": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"subject": {
"type": "string"
},
"can_edit": {
"type": "boolean"
},
"iconfarm": {
"type": "string"
},
"lastedit": {
"type": "string"
},
"can_reply": {
"type": "boolean"
},
"is_locked": {
"type": "boolean"
},
"is_sticky": {
"type": "boolean"
},
"authorname": {
"type": "string"
},
"can_delete": {
"type": "boolean"
},
"datecreate": {
"type": "string"
},
"iconserver": {
"type": "string"
},
"last_reply": {
"type": "string"
},
"datelastpost": {
"type": "string"
},
"count_replies": {
"type": "integer"
},
"author_is_deleted": {
"type": "boolean"
},
"author_path_alias": {
"type": "string"
}
}
}
TopicReply
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"author": {
"type": "string"
},
"is_pro": {
"type": "boolean"
},
"message": {
"type": "object",
"properties": {
"_content": {
"type": "string"
}
}
},
"can_edit": {
"type": "boolean"
},
"iconfarm": {
"type": "string"
},
"lastedit": {
"type": "string"
},
"authorname": {
"type": "string"
},
"can_delete": {
"type": "boolean"
},
"datecreate": {
"type": "string"
},
"iconserver": {
"type": "string"
},
"author_is_deleted": {
"type": "boolean"
},
"author_path_alias": {
"type": "string"
}
}
}
URL
{
"type": "object",
"properties": {
"type": {
"type": "string"
},
"_content": {
"type": "string"
}
}
}