NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Bucket List API

The Bucket List API provides thousands of innovative bucket list ideas for every type of person.

(4.3)

From 8,905 users

2,300+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
331ms347ms380ms820ms1201ms

Didn't find what you were looking for? Suggest an improvement

/v1/bucketlist GET

https://api.api-ninjas.com/v1/bucketlist

Returns a random bucket list idea.

Parameters

None

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • item

    A random bucket list idea or activity.

Sample Request Live Demo!

Try this endpoint live with a free API key

Instant access — no credit card required.

https://api.api-ninjas.com/v1/bucketlist

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
{
    item:"Attend Carnaval in Brazil"
}

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/bucketlist" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Bucket List API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • A GET request to the /v1/bucketlist endpoint returns a JSON object with a single item field containing a random bucket list idea or activity, such as 'Attend Carnaval in Brazil'. If the request is unsuccessful you'll receive an error code instead.
  • The /v1/bucketlist endpoint takes no query parameters, so each call simply returns one random idea and there is no way to filter by category or difficulty; to get a fresh idea, just repeat the request. You can review all available endpoints and their parameters in our API catalog.
  • Because each call returns a single inspirational item, it is ideal for goal-setting apps, 'idea of the day' widgets, and lifestyle or travel sites that surface a random activity to users. It pairs well with the Hobbies API for activity suggestions and the Quotes API for added motivation.
  • Every request to /v1/bucketlist must include your API key in the X-Api-Key request header, which is the only required header for this endpoint. You can find your key and usage limits on the pricing page after creating an account.