{"openapi":"3.1.0","info":{"title":"Photos API","version":"1.0.0","description":"Real stock photography as an API, powered by Lorem Picsum. Browse a curated catalogue of high-resolution photos with their author and dimensions, look up any photo by id, or build a ready-to-embed image URL on the fly — pick a width and height and get a random photo, pass a seed for a stable deterministic image (the same seed always returns the same photo, ideal for consistent placeholders per user or item), or target a specific photo by id, with optional grayscale and blur. No accounts, no attribution headaches: every image is a clean, hotlinkable URL. Perfect for mockups and design comps, blog and CMS placeholders, app prototypes, test fixtures and any layout that needs real imagery instead of grey boxes.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/photos-api","description":"oanor gateway"}],"tags":[{"name":"Photos"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Photos"],"summary":"A page of curated photos","description":"","parameters":[{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Photos per page (1-100, default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":30,"photos":[{"id":"0","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/yC-Yzbqy7PY","download_url":"https://picsum.photos/id/0/5000/3333"},{"id":"1","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/LNRyGwIJr5c","download_url":"https://picsum.photos/id/1/5000/3333"},{"id":"2","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/N7XodRrbzS0","download_url":"https://picsum.photos/id/2/5000/3333"},{"id":"3","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/Dl6jeyfihLk","download_url":"https://picsum.photos/id/3/5000/3333"},{"id":"4","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/y83Je1OC6Wc","download_url":"https://picsum.photos/id/4/5000/3333"},{"id":"5","width":5000,"author":"Alejandro Escamilla","height":3334,"source_url":"https://unsplash.com/photos/LF8gK8-HGSg","download_url":"https://picsum.photos/id/5/5000/3334"},{"id":"6","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/tAKXap853rY","download_url":"https://picsum.photos/id/6/5000/3333"},{"id":"7","width":4728,"author":"Alejandro Escamilla","height":3168,"source_url":"https://unsplash.com/photos/BbQLHCpVUqA","download_url":"https://picsum.photos/id/7/4728/3168"},{"id":"8","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/xII7efH1G6o","download_url":"https://picsum.photos/id/8/5000/3333"},{"id":"9","width":5000,"author":"Alejandro Escamilla","height":3269,"source_url":"https://unsplash.com/photos/ABDTiLqDhJA","download_url":"https://picsum.photos/id/9/5000/3269"},{"id":"10","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/6J--NXulQCs","download_url":"https://picsum.photos/id/10/2500/1667"},{"id":"11","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/Cm7oKel-X2Q","download_url":"https://picsum.photos/id/11/2500/1667"},{"id":"12","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/I_9ILwtsl_k","download_url":"https://picsum.photos/id/12/2500/1667"},{"id":"13","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/3MtiSMdnoCo","download_url":"https://picsum.photos/id/13/2500/1667"},{"id":"14","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/IQ1kOQTJrOQ","download_url":"https://picsum.photos/id/14/2500/1667"},{"id":"15","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/NYDo21ssGao","download_url":"https://picsum.photos/id/15/2500/1667"},{"id":"16","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/gkT4FfgHO5o","download_url":"https://picsum.photos/id/16/2500/1667"},{"id":"17","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/Ven2CV8IJ5A","download_url":"https://picsum.photos/id/17/2500/1667"},{"id":"18","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/Ps2n0rShqaM","download_url":"https://picsum.photos/id/18/2500/1667"},{"id":"19","width":2500,"author":"Paul Jarvis","height":1667,"source_url":"https://unsplash.com/photos/P7Lh0usGcuk","download_url":"https://picsum.photos/id/19/2500/1667"},{"id":"20","width":3670,"author":"Aleks Dorohovich","height":2462,"source_url":"https://unsplash.com/photos/nJdwUHmaY8A","download_url":"https://picsum.photos/id/20/3670/2462"},{"id":"21","width":3008,"author":"Alejandro Escamilla","height":2008,"source_url":"https://unsplash.com/photos/jVb0mSn0LbE","download_url":"https://picsum.photos/id/21/3008/2008"},{"id":"22","width":4434,"author":"Alejandro Escamilla","height":3729,"source_url":"https://unsplash.com/photos/du_OrQAA4r0","download_url":"https://picsum.photos/id/22/4434/3729"},{"id":"23","width":3887,"author":"Alejandro Escamilla","height":4899,"source_url":"https://unsplash.com/photos/8yqds_91OLw","download_url":"https://picsum.photos/id/23/3887/4899"},{"id":"24","width":4855,"author":"Alejandro Escamilla","height":1803,"source_url":"https://unsplash.com/photos/cZhUxIQjILg","download_url":"https://picsum.photos/id/24/4855/1803"},{"id":"25","width":5000,"author":"Alejandro Escamilla","height":3333,"source_url":"https://unsplash.com/photos/Iuq0EL4EINY","download_url":"https://picsum.photos/id/25/5000/3333"},{"id":"26","width":4209,"author":"Vadim Sherbakov","height":2769,"source_url":"https://unsplash.com/photos/tCICLJ5ktBE","download_url":"https://picsum.photos/id/26/4209/2769"},{"id":"27","width":3264,"author":"Yoni Kaplan-Nadel","height":1836,"source_url":"https://unsplash.com/photos/iJnZwLBOB1I","download_url":"https://picsum.photos/id/27/3264/1836"},{"id":"28","width":4928,"author":"Jerry Adney","height":3264,"source_url":"https://unsplash.com/photos/_WiFMBRT7Aw","download_url":"https://picsum.photos/id/28/4928/3264"},{"id":"29","width":4000,"author":"Go Wild","height":2670,"source_url":"https://unsplash.com/photos/V0yAek6BgGk","download_url":"https://picsum.photos/id/29/4000/2670"}]},"meta":{"timestamp":"2026-06-01T00:04:36.474Z","request_id":"cda45e13-b31f-41a3-bbae-4d17e2b5f95a"},"status":"ok","message":"Photos listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/photo":{"get":{"operationId":"get_v1_photo","tags":["Photos"],"summary":"A photo's info by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Photo id, e.g. 237","schema":{"type":"string"},"example":"237"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"photo":{"id":"237","width":3500,"author":"André Spieker","height":2095,"source_url":"https://unsplash.com/photos/8wTPqxlnKM4","download_url":"https://picsum.photos/id/237/3500/2095"}},"meta":{"timestamp":"2026-06-01T00:04:36.583Z","request_id":"351843ec-8e7c-4eaf-bcc1-d5044f8dc868"},"status":"ok","message":"Photo retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/url":{"get":{"operationId":"get_v1_url","tags":["Photos"],"summary":"Build a placeholder-photo URL","description":"","parameters":[{"name":"width","in":"query","required":false,"description":"Width in px (1-5000, default 600)","schema":{"type":"string"},"example":"600"},{"name":"height","in":"query","required":false,"description":"Height in px (1-5000, default = width)","schema":{"type":"string"},"example":"400"},{"name":"seed","in":"query","required":false,"description":"Seed for a deterministic image (same seed = same photo)","schema":{"type":"string"},"example":"oanor"},{"name":"id","in":"query","required":false,"description":"Target a specific photo id","schema":{"type":"string"}},{"name":"grayscale","in":"query","required":false,"description":"true for a grayscale image","schema":{"type":"string"}},{"name":"blur","in":"query","required":false,"description":"Blur amount 1-10","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"url":"https://picsum.photos/seed/oanor/600/400","mode":"seeded (deterministic)","seed":"oanor","width":600,"height":400,"grayscale":false},"meta":{"timestamp":"2026-06-01T00:04:36.693Z","request_id":"757a1640-b54b-4569-b91f-ae37ac778208"},"status":"ok","message":"Photo URL built","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Real stock photography. /v1/list = a page of curated photos (author, dimensions, download URL); /v1/photo = a photo's info by id (e.g. id=237); /v1/url = build a ready-to-embed photo URL by size, with seed= for a deterministic image, id= for a specific photo, or neither for random — plus optional grayscale and blur=1-10. Photos are CC-licensed via Unsplash, served by Lorem Picsum.","source":"Lorem Picsum (picsum.photos)","endpoints":["/v1/list","/v1/photo","/v1/url","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:36.765Z","request_id":"e5cf221e-e33f-456a-bb8c-4c6ad39b8f79"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":360,"monthly_call_quota":180000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1060,"monthly_call_quota":850000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3140,"monthly_call_quota":3500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/photos-api"}