# Lorem Ipsum API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/lorem-api/..."
```

## Pricing
- **Free** (Free) — 17,000 calls/Mo, 2 req/s
- **Starter** ($2/Mo) — 240,000 calls/Mo, 8 req/s
- **Pro** ($8/Mo) — 940,000 calls/Mo, 20 req/s
- **Mega** ($27/Mo) — 3,900,000 calls/Mo, 50 req/s

## Endpoints

### Lorem

#### `GET /v1/bytes` — Generate exactly N bytes

**Parameters:**
- `count` (query, optional, string) — Byte length (1-10000, default 200) Example: `200`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorem-api/v1/bytes?count=200"
```

**Response:**
```json
{
    "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
}
```

#### `GET /v1/list` — Generate bullet-list items

**Parameters:**
- `count` (query, optional, string) — How many (1-100, default 5) Example: `5`
- `format` (query, optional, string) — text or html Example: `text`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorem-api/v1/list?count=5&format=text"
```

**Response:**
```json
{
    "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
}
```

#### `GET /v1/paragraphs` — Generate paragraphs

**Parameters:**
- `count` (query, optional, string) — How many (1-50, default 3) Example: `3`
- `format` (query, optional, string) — text or html Example: `text`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorem-api/v1/paragraphs?count=3&format=text"
```

**Response:**
```json
{
    "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
}
```

#### `GET /v1/sentences` — Generate sentences

**Parameters:**
- `count` (query, optional, string) — How many (1-100, default 5) Example: `5`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorem-api/v1/sentences?count=5"
```

**Response:**
```json
{
    "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
}
```

#### `GET /v1/words` — Generate words

**Parameters:**
- `count` (query, optional, string) — How many (1-1000, default 25) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorem-api/v1/words?count=25"
```

**Response:**
```json
{
    "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
}
```

### Meta

#### `GET /v1/meta` — Usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorem-api/v1/meta"
```

**Response:**
```json
{
    "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
}
```


---
Marketplace page: https://www.oanor.com/api/lorem-api
OpenAPI spec: https://www.oanor.com/api/lorem-api/openapi.json