{"name":"Shigg.ee API","version":"v1","base":"https://api.shigg.ee/v1","docs":"https://shigg.ee/developers","rules":{"No key, no sign-in":"Every call here is a plain GET. Browsers may call it from any site (CORS is open).","Versioned":"Everything lives under /v1 and stays compatible: fields may be added, none taken away or changed. A breaking change would get /v2.","JSON":"Times are ISO 8601, every address is absolute. Errors answer with a status and { \"error\": \"…\" }.","Fair use":"Limits per IP, a few hundred calls per ten minutes and endpoint. Past them: 429 and Retry-After. Answers may be cached for a minute."},"endpoints":[{"method":"GET","url":"https://api.shigg.ee/v1/pictures","title":"List and search pictures","about":"Every public picture, a page at a time. With ?q= and no ?sort=, the best matches come first.","params":{"q":"Words to look for in names, artists, tags and collections.","collection":"A collection's slug.","tag":"A tag's slug.","type":"image, gif or video.","sort":"new (default), old, name or popular.","limit":"How many, 1-100 (24 unless said).","offset":"Where to start; the answer's `next` is the offset of the next page, or null."}},{"method":"GET","url":"https://api.shigg.ee/v1/pictures/{hash}","title":"One picture","about":"Everything public about one picture, with ready-made addresses for its page, file, preview and any size."},{"method":"GET","url":"https://api.shigg.ee/v1/pictures/{hash}/similar","title":"Similar pictures","about":"Public pictures that share its tags, collections and colour.","params":{"limit":"How many, 1-24 (12)."}},{"method":"GET","url":"https://api.shigg.ee/v1/pictures/random","title":"A random picture","about":"One public picture by chance - a new one every call.","params":{"collection":"Only from this collection (slug).","type":"image, gif or video."}},{"method":"GET","url":"https://api.shigg.ee/v1/collections","title":"Collections","about":"The public collections in the site's order, with their colour and how many public pictures each holds."},{"method":"GET","url":"https://api.shigg.ee/v1/tags","title":"Tags","about":"Every tag a public picture carries, with how many carry it."},{"method":"GET","url":"https://api.shigg.ee/v1/lists/{username}/{slug}","title":"A public list","about":"A list someone made public, with its pictures. Append /zip for all files in one .zip."},{"method":"GET","url":"https://api.shigg.ee/v1/daily","title":"Today","about":"Today's picture of the day, the others the day shows (`also`), and how it was chosen - by the community's vote or by chance."},{"method":"GET","url":"https://api.shigg.ee/v1/daily/{YYYY-MM-DD}","title":"A day gone by","about":"The same for any earlier day. Days still to come stay closed."},{"method":"GET","url":"https://api.shigg.ee/v1/oembed","title":"oEmbed","about":"oEmbed 1.0 (JSON) for a picture's address - what chat apps and CMSes use to build a card.","params":{"url":"The picture's address, e.g. https://shigg.ee/{hash}.","hash":"Or the hash straight away."}}]}