Bucket List API

GET

Give users a spontaneous goal or life experience to pursue.

Bucket List supplies a random bucket list idea for life goals, travel aspirations, and personal adventures. Call the endpoint with no parameters to receive a single activity suggestion.

Try it — live request, no key required

Request

GETapi.apiverve.com/v1/bucketlist

Verification

Format

No key required to try it. Get a key to use it in your app.

Example

{
  "status": "ok",
  "error": null,
  "data": {
    "bucketListItem": "Go on a educational trip"
  }
}

About the Bucket List API

Sending a GET request requires no parameters or query filters. The service selects an entry at random from its activity catalog and returns a single text string in the response. Because calls are stateless, each request independently generates an activity suggestion.

What people use it for

Daily Inspiration Widget: Travel apps fetch a random goal each morning to present users with fresh adventure ideas on their home screen.
Goal Planner Onboarding: When users create a blank profile, habit trackers display an activity prompt to spark personal goal setting.
Team Icebreaker Prompts: Prompt remote coworkers during meetings by displaying a random life achievement idea for participants to discuss.
Social Bot Publishing: Schedule social media accounts to broadcast an adventurous life aspiration every week without drafting prompts manually.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON: Default REST response
XML: Markup format
YAML: Human-readable
CSV: Tabular export
GraphQL: Query language
MCP: For AI agents

View all integrations →

Other ways to use Bucket List

Same data, same APIVerve account, same credit balance — one key works on all of them.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.on VerveKit

Questions.

Common questions about the Bucket List API.

Read the docs →

How far does the Starter plan go for bucket list suggestions?

Starter covers 100,000 calls each month, using 2 credits per request from your monthly allowance. That works out to about $0.30 per 1,000 calls. If you are evaluating the service or building a prototype, the Free plan provides 100 calls per month.

Can I filter bucket list items by category or destination?

No, the endpoint takes no parameters and returns a random suggestion from the database on every call. If your project requires filtering by theme or location, you need to handle that matching on your side after receiving the item.

Can I retrieve multiple bucket list items in one request?

No, each call delivers exactly one bucket list item. If you want to present a batch of suggestions to a user, make a separate request for each one.

What information does each response include?

Each response contains a single bucket list item string. The API does not return secondary metadata such as tags, estimated costs, difficulty levels, or source links.

Are suggestions guaranteed to be unique across requests?

No, each request independently selects an item at random. Because selections are stateless, repeat suggestions can occur over time, so you should track returned items in your application if you need to enforce uniqueness during a session.

Request parameters — GET /v1/bucketlist

This endpoint takes no parameters

Call it with your key and nothing else. Any query string you send is ignored rather than rejected.

Example request

1
2

curl "https://api.apiverve.com/v1/bucketlist" \
  -H "x-api-key: YOUR_API_KEY"

Authentication

Send your key in the x-api-key header. That is the only auth step — no token exchange, and no per-endpoint scope to configure.

Header	When	Value
`x-api-key`Required	Every request	Your API key. Header names are case-insensitive, so `X-API-Key` is the same header.
`Authorization`Alternate	Instead of the above	`Bearer <key>` — for clients that only expose bearer auth. Resolves to the same account and the same billing.

401 is the only auth verdict

A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.

Response — GET /v1/bucketlist

Every APIVerve endpoint returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape.

Sample response

{
  "status": "ok",
  "error": null,
  "data": {
    "bucketListItem": "Go on a educational trip"
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Field	Type	Example	Description
`bucketListItem`	string	`"Go on a educational trip"`	Random bucket list item from the database

Response headers

Every response carries your balance, so your own code always knows where it stands without polling anything. All four are exposed to browsers through CORS.

Header	What it carries
`x-api-remaining-credits`	Credits left in the current cycle
`x-api-credits-used`	Credits spent in the current cycle
`x-api-max-credits`	The allowance for the cycle
`x-api-version`	Version of the endpoint that answered

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change.

Status	Meaning	What to do
`400`	Input was rejected	Read `error`; it names the parameter that has to change.
`401`	Key missing or invalid	Check the header name and the key value.
`403`	Key valid, but not permitted here	A key restriction or an IP allow-list — never a bad key.
`429`	Rate limited, or out of credits	Read `error` to tell them apart, then back off or top up.

What a call costs — 2 credits per call

Credits are shared across every APIVerve API — one balance, one key, one bill. Failed requests never count against it, so a rejected input costs nothing.

Plan	Per month	Credits	Bucket List calls	Per 1,000 calls
Free	Free	200	100	Free
Starter	$29.99	200,000	100,000	$0.30
Pro	$99.99	1,000,000	500,000	$0.20
Mega	$299.99	4,000,000	2,000,000	$0.15

Calls are what the credits buy at this API's rate — spend them here, on any of the other APIs, or across both. Nothing is reserved per endpoint.

Compare all pricing tiers →

Call it from cURL — GET /v1/bucketlist

No SDK to install — this is a plain HTTPS call to /v1/bucketlist with your key in the x-api-key header. Swap in a real key and it runs as-is.

cURL

1
2

curl "https://api.apiverve.com/v1/bucketlist" \
  -H "x-api-key: YOUR_API_KEY"

Resources

GitHubapiverve/bucketlist-apiSource, issues and the examples this page is built from.ReferenceBucket List API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Also published for

@apiverve/bucketlistnpm apiverve-bucketlistPyPI APIVerve.API.BucketListNuGet

Only the languages APIVerve ships a client for are listed — the rest call the endpoint directly over HTTPS.

Call it from Node.js — GET /v1/bucketlist

Install the Node.js SDK, then call the Bucket List API with your key. The client wraps the same HTTPS request, so anything it returns is what the endpoint returns.

Install — npm

npm install @apiverve/bucketlist

Node.js

const res = await fetch("https://api.apiverve.com/v1/bucketlist", {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const { data } = await res.json();
console.log(data);

Resources

npm@apiverve/bucketlistThe published Node.js client, versioned and signed.GitHubapiverve/bucketlist-apiSource, issues and the examples this page is built from.ReferenceBucket List API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Also published for

apiverve-bucketlistPyPI APIVerve.API.BucketListNuGet

Only the languages APIVerve ships a client for are listed — the rest call the endpoint directly over HTTPS.

Call it from Python — GET /v1/bucketlist

Install the Python SDK, then call the Bucket List API with your key. The client wraps the same HTTPS request, so anything it returns is what the endpoint returns.

Install — PyPI

pip install apiverve-bucketlist

Python

import requests

res = requests.get(
    "https://api.apiverve.com/v1/bucketlist",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(res.json()["data"])

Resources

PyPIapiverve-bucketlistThe published Python client, versioned and signed.GitHubapiverve/bucketlist-apiSource, issues and the examples this page is built from.ReferenceBucket List API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Also published for

@apiverve/bucketlistnpm APIVerve.API.BucketListNuGet

Only the languages APIVerve ships a client for are listed — the rest call the endpoint directly over HTTPS.

Call it from C# / .NET — GET /v1/bucketlist

Install the C# / .NET SDK, then call the Bucket List API with your key. The client wraps the same HTTPS request, so anything it returns is what the endpoint returns.

Install — NuGet

dotnet add package APIVerve.API.BucketList

C# / .NET

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var json = await client.GetStringAsync("https://api.apiverve.com/v1/bucketlist");
Console.WriteLine(json);

Resources

NuGetAPIVerve.API.BucketListThe published C# / .NET client, versioned and signed.GitHubapiverve/bucketlist-apiSource, issues and the examples this page is built from.ReferenceBucket List API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Also published for

@apiverve/bucketlistnpm apiverve-bucketlistPyPI

Only the languages APIVerve ships a client for are listed — the rest call the endpoint directly over HTTPS.

Call it from Go — GET /v1/bucketlist

No SDK to install — this is a plain HTTPS call to /v1/bucketlist with your key in the x-api-key header. Swap in a real key and it runs as-is.

req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/bucketlist", nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))

Resources

Also published for

@apiverve/bucketlistnpm apiverve-bucketlistPyPI APIVerve.API.BucketListNuGet

Only the languages APIVerve ships a client for are listed — the rest call the endpoint directly over HTTPS.

Call it from PHP — GET /v1/bucketlist

No SDK to install — this is a plain HTTPS call to /v1/bucketlist with your key in the x-api-key header. Swap in a real key and it runs as-is.

PHP

$ch = curl_init("https://api.apiverve.com/v1/bucketlist");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);

$response = curl_exec($ch);
echo $response;

Resources

Also published for

@apiverve/bucketlistnpm apiverve-bucketlistPyPI APIVerve.API.BucketListNuGet

Only the languages APIVerve ships a client for are listed — the rest call the endpoint directly over HTTPS.

Call it from Ruby — GET /v1/bucketlist

No SDK to install — this is a plain HTTPS call to /v1/bucketlist with your key in the x-api-key header. Swap in a real key and it runs as-is.

Ruby

require "net/http"

uri = URI("https://api.apiverve.com/v1/bucketlist")
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = "YOUR_API_KEY"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

Resources

Also published for

@apiverve/bucketlistnpm apiverve-bucketlistPyPI APIVerve.API.BucketListNuGet

Only the languages APIVerve ships a client for are listed — the rest call the endpoint directly over HTTPS.

All articles →

Python API Tutorial: Your First APIVerve Call10 lines of Python. That's all it takes to call 300+ APIs. Here's the complete quickstart for Python developers.Read

REST vs GraphQL: Which Should You Use?Skip the theory. Here's when to use REST endpoints and when GraphQL actually makes sense.Read

Complete Guide to API Testing with PostmanMaster API testing with Postman. Learn collections, environments, automated tests, and debugging techniques.Read

Bucket List API

Try it — live request, no key required

About the Bucket List API

What people use it for

Ways to call it

Other ways to use Bucket List

Questions.

Request parameters — GET /v1/bucketlist

Authentication

Response — GET /v1/bucketlist

Response fields

Response headers

Errors

What a call costs — 2 credits per call

Call it from cURL — GET /v1/bucketlist

Resources

Also published for

Call it from Node.js — GET /v1/bucketlist

Resources

Also published for

Call it from Python — GET /v1/bucketlist

Resources

Also published for

Call it from C# / .NET — GET /v1/bucketlist

Resources

Also published for

Call it from Go — GET /v1/bucketlist

Resources

Also published for

Call it from PHP — GET /v1/bucketlist

Resources

Also published for

Call it from Ruby — GET /v1/bucketlist

Resources

Also published for

Zero-code embed — one snippet, no backend

Changelog — Bucket List API

Entertainment

Related articles

Ready to build with Bucket List? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog