{"openapi":"3.1.0","info":{"title":"Lorem Ipsum API","version":"1.0.0","description":"Generate classic Lorem Ipsum placeholder text as an API — exactly as much as you need, in the shape you need. Request a number of words, sentences, paragraphs (as plain text or ready-to-drop-in HTML <p> tags), bullet-list items, or an exact byte length. Prose can start with the canonical \"Lorem ipsum dolor sit amet, consectetur adipiscing elit…\" or with random Latin. Generated entirely on the server, so it is instant and always available — no third-party calls. Ideal for mockups and design comps, CMS and template seeding, UI prototyping, test fixtures and load-test payloads, and anywhere a layout needs filler copy.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/lorem-api","description":"oanor gateway"}],"tags":[{"name":"Lorem"},{"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/bytes":{"get":{"operationId":"get_v1_bytes","tags":["Lorem"],"summary":"Generate exactly N bytes","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"Byte length (1-10000, default 200)","schema":{"type":"string"},"example":"200"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"excepteur cupidatat aperiam numquam perspiciatis ut ut unde sit eiusmod vel voluptate beatae quisquam aliquid ipsa ea ullamco ipsum ea quis illum ipsam eum vel laboris anim irure mollit perspiciatis e","type":"bytes","count":200},"meta":{"timestamp":"2026-06-01T00:04:24.015Z","request_id":"7d856012-6a1b-49bd-9de4-3c42cf11b741"},"status":"ok","message":"Bytes generated","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/list":{"get":{"operationId":"get_v1_list","tags":["Lorem"],"summary":"Generate bullet-list items","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many (1-100, default 5)","schema":{"type":"string"},"example":"5"},{"name":"format","in":"query","required":false,"description":"text or html","schema":{"type":"string"},"example":"text"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"- Eu voluptas odit elit enim sunt\n- Ab ex exercitationem nisi inventore\n- Veniam sit eius doloremque\n- Amet quis tempor enim id exercitation\n- Vel ea quo","type":"list","count":5,"items":["Eu voluptas odit elit enim sunt","Ab ex exercitationem nisi inventore","Veniam sit eius doloremque","Amet quis tempor enim id exercitation","Vel ea quo"],"format":"text"},"meta":{"timestamp":"2026-06-01T00:04:24.091Z","request_id":"f9993e79-5ef3-49a0-bcb9-f52dbdd954a1"},"status":"ok","message":"List generated","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/paragraphs":{"get":{"operationId":"get_v1_paragraphs","tags":["Lorem"],"summary":"Generate paragraphs","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many (1-50, default 3)","schema":{"type":"string"},"example":"3"},{"name":"format","in":"query","required":false,"description":"text or html","schema":{"type":"string"},"example":"text"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"Lorem ipsum dolor sit amet, consectetur adipiscing. Culpa incidunt eos ipsam consectetur nihil eos, magna eaque est. Fugiat officia ipsa numquam inventore voluptatem. Non ullamco quis corporis, deserunt tempor enim adipiscing culpa exercitationem. Sint dolore corporis anim nulla nemo, voluptas nulla voluptas quam aliqua. Sequi nihil deserunt sed fugiat corporis, ipsam voluptate aspernatur veritatis sit in odit illum. Eaque exercitation eaque laboris ratione, illo dolor.\n\nAspernatur sint cupidatat consequat aute dolores. Aspernatur exercitationem rem perspiciatis proident ex dolore labore explicabo, qui voluptatem ab dicta perspiciatis. Voluptas fugit natus id dolores tempora sunt esse, sunt elit aute ea iste officia lorem. Totam natus labore eu autem ipsam enim sequi, nesciunt sint inventore commodi corporis.\n\nQuis aliquid sed veniam ullam, lorem reprehenderit. Architecto natus magna irure, voluptatem exercitation inventore quo voluptatem vel eius sit. Enim velit commodi architecto error, totam voluptate.","type":"paragraphs","count":3,"format":"text"},"meta":{"timestamp":"2026-06-01T00:04:24.162Z","request_id":"d694fdc6-68ba-4db4-a9ee-57ddf9f4bce6"},"status":"ok","message":"Paragraphs generated","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/sentences":{"get":{"operationId":"get_v1_sentences","tags":["Lorem"],"summary":"Generate sentences","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many (1-100, default 5)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"Lorem ipsum dolor sit amet consectetur adipiscing, elit dolore pariatur. Adipisci incidunt quo ipsum, occaecat nemo adipisci occaecat iure unde minima voluptas magni. Fugiat magnam perspiciatis illo pariatur quaerat, rem sit. Irure totam nemo autem, quasi non magnam excepteur anim sequi. Laboriosam aute eiusmod voluptate sunt ullamco commodo consequat magni molestiae, porro modi exercitationem.","type":"sentences","count":5},"meta":{"timestamp":"2026-06-01T00:04:24.209Z","request_id":"b4cffc4a-0201-409f-9f24-fba93b2458dd"},"status":"ok","message":"Sentences generated","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/words":{"get":{"operationId":"get_v1_words","tags":["Lorem"],"summary":"Generate words","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many (1-1000, default 25)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"lorem ipsum dolor sit amet consectetur adipiscing elit cupidatat architecto accusantium aut eum nesciunt illum minim id officia duis omnis et aliquid magnam fugit excepteur","type":"words","count":25},"meta":{"timestamp":"2026-06-01T00:04:24.262Z","request_id":"b4749b0f-a153-42e4-8bb9-bd9873ac53cc"},"status":"ok","message":"Words generated","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":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Classic Lorem Ipsum placeholder text. /v1/paragraphs?count=3&format=text|html (start_lorem=true begins with the canonical 'Lorem ipsum dolor…'); /v1/sentences?count=5; /v1/words?count=25; /v1/list?count=5&format=text|html (bullet items); /v1/bytes?count=200 (exact byte length). Generated locally — fast and always available.","source":"local Lorem Ipsum generator","endpoints":["/v1/paragraphs","/v1/sentences","/v1/words","/v1/list","/v1/bytes","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:24.316Z","request_id":"a1d2fd8f-5485-4749-83d9-43963d17af5f"},"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":17000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":220,"monthly_call_quota":240000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":800,"monthly_call_quota":940000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2720,"monthly_call_quota":3900000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/lorem-api"}