The Recipe Ipsum REST API

Use the ever faithful Curl, or the trendy upstart HTTPie, to generate ipsum copy straight from the command-line using the free ipsum API:

#! /bin/sh

# Use curl to fetch, and Python to format
curl -s "https://recipe-ipsum.net/api/icw/v1/generate" | python -m json.tool

# Use HTTPie to fetch, and jq for format
http GET "https://recipe-ipsum.net/api/icw/v1/generate" | jq .

# Use HTTPie to fetch 10 paragraphs without the fixed/suggested opening sentence, and jq for format
http GET "https://recipe-ipsum.net/api/icw/v1/generate?paragraphs=10&start_with_fixed=0" | jq .

Ipsum API URL

https://recipe-ipsum.net/api/icw/v1

/generate

ParameterUsage
paragraphsType: int
How many paragraphs of copy do you want? This value is sanity checked against the server’s configuration, so if you pass it some text here, or specify a silly-big number, you’ll either get an error, or a capped number or paragraphs. Similarly if you try to feed it a negative value.
start_with_fixedType: bool (1 or 0)
If the ipsum dictionary comes with an optional suggested opening sentence, then you can choose to use it here by specifying a value of one. If you don’t specify one or zero then the server may or may not include the suggested opening sentence, depending on how the API has been configured.
GET parameters for the /generate endpoint.

Fair Use & Throttling

We monitor and occasionally throttle API requests. So if you batter API with 100 requests per second, don’t be surprised if you start seeing funny error messages.

We might even block your IP address with the firewall, or even send you to the naughty step to think about what you’ve done.