Developer reference
Idea Data Bank API docs
A key-authenticated, read-only REST API over the researched business idea catalog. Base URL: https://www.unleashyourideas.com/api/v1/idea-bank. All endpoints are GET, all responses are JSON, and CORS is open so you can call it straight from a browser. Need a key? Create one free. Prefer tooling? The OpenAPI 3 spec describes every endpoint machine-readably, ready for Postman, Insomnia, or client generators.
Authentication
Every request carries your key, either as a bearer token or an x-api-key header. Keys look like uyi_live_ followed by 32 hex characters, are shown once at creation, and can be revoked any time at /settings/api-keys.
curl
curl -H "Authorization: Bearer uyi_live_YOUR_KEY" \ "https://www.unleashyourideas.com/api/v1/idea-bank/meta" # or the header form curl -H "x-api-key: uyi_live_YOUR_KEY" \ "https://www.unleashyourideas.com/api/v1/idea-bank/meta"
Quotas and rate limits
Every authenticated request counts one call against the key's monthly quota, which resets when the calendar month rolls over (UTC). Each key also has a burst ceiling of 60 requests per minute. Successful responses include X-Monthly-Quota and X-Monthly-Remaining headers. The free tier requires a visible attribution link back to unleashyourideas.com wherever the data shows publicly.
| Tier | Price | Calls per month | Active keys |
|---|---|---|---|
| Free | $0 | 500 | 1 |
| Builder | $29/mo | 25,000 | 3 |
| Pro | $99/mo | 250,000 | 5 |
| Scale | $299/mo | 1,500,000 | 10 |
Errors
Every error is JSON with a stable machine code and a human message:
{
"error": {
"code": "quota_exceeded",
"message": "Monthly quota of 500 requests reached for this key. ..."
}
}| Status | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No key on the request. Pass Authorization: Bearer <key> or x-api-key. |
| 401 | unknown_key | The key does not exist (check for copy-paste damage). |
| 403 | key_revoked | The key was revoked on the key page. Create a new one. |
| 429 | rate_limited | Per-minute burst ceiling reached (60 requests/minute per key). Retry shortly. |
| 429 | quota_exceeded | The key's monthly quota is used up. Resets at the start of next month (UTC), or upgrade. |
| 400 | bad_request | A parameter is out of range or unrecognized; the message says which. |
| 404 | not_found | No idea or list matches that id or slug. |
| 503 | service_unavailable | Brief hiccup on our side. Retry with backoff. |
List ideas
GET /api/v1/idea-bank/ideas returns paginated idea summaries. All filters combine (AND) and match case-insensitively. Valid filter values come from the categories endpoint.
| Parameter | Description |
|---|---|
limit | Page size, 1 to 100. Default 25. |
offset | Rows to skip. Default 0. |
q | Text search across title, description, and topics. |
category | Exact category, e.g. "Local Services". |
industry | Exact industry. |
budgetTier | free | under-100 | under-1k | under-5k | 5k-plus |
timeBand | under-30 | 30-90 | 90-plus (days to first dollar) |
difficulty | Beginner | Intermediate | Advanced |
audience | B2B | B2C | Both |
businessType | Service | Product | Content | Marketplace | SaaS |
trait | One trait, e.g. "AI-friendly", "Home-based", "Low startup cost". |
sort | relevance (default) | searches | viability | newest | title |
curl
curl -H "Authorization: Bearer uyi_live_YOUR_KEY" \ "https://www.unleashyourideas.com/api/v1/idea-bank/ideas?budgetTier=under-1k&difficulty=Beginner&limit=10"
JavaScript (fetch)
const res = await fetch(
"https://www.unleashyourideas.com/api/v1/idea-bank/ideas?q=cleaning&sort=viability&limit=10",
{ headers: { Authorization: "Bearer uyi_live_YOUR_KEY" } }
);
const { data, pagination } = await res.json();Python (requests)
import requests
res = requests.get(
"https://www.unleashyourideas.com/api/v1/idea-bank/ideas",
params={"category": "Local Services", "limit": 10},
headers={"x-api-key": "uyi_live_YOUR_KEY"},
)
ideas = res.json()["data"]Sample response
{
"data": [
{
"id": "start-a-business",
"title": "Start a Business (the Foundations)",
"description": "This is the foundational path every idea on this site eventually walks: pick the thing you will sell, form the entity, get the free EIN, open the business bank account, and land the first sale. It is not an online idea or an offline idea; it is the ground floor underneath all of them, and it runs anywhere.",
"category": "Education & Training",
"industry": "General",
"startupCost": "Under $500",
"budgetTier": "under-1k",
"timeToFirstDollar": "Depends on the idea you attach it to",
"timeBand": "under-30",
"difficulty": "Beginner",
"revenuePotential": "High",
"viability": 9.5,
"traits": [
"Beginner friendly",
"Low startup cost",
"Fast launch",
"Local business"
],
"location": "Hybrid",
"audience": "Both",
"businessType": "Service"
}
],
"pagination": {
"total": 5043,
"limit": 1,
"offset": 0,
"hasMore": true
}
}One idea, full depth
GET /api/v1/idea-bank/ideas/{id} returns everything the catalog knows about one idea: the summary fields plus the how-to-start steps, the deeper evaluation fields where they exist, and revenueEstimate when our research covers the idea. Optional fields are omitted when the research does not exist; the API never fills gaps with invented numbers.
curl
curl -H "Authorization: Bearer uyi_live_YOUR_KEY" \ "https://www.unleashyourideas.com/api/v1/idea-bank/ideas/IDEA_ID"
Sample response
{
"data": {
"id": "start-a-business",
"title": "Start a Business (the Foundations)",
"description": "This is the foundational path every idea on this site eventually walks: pick the thing you will sell, form the entity, get the free EIN, open the business bank account, and land the first sale. It is not an online idea or an offline idea; it is the ground floor underneath all of them, and it runs anywhere.",
"category": "Education & Training",
"industry": "General",
"startupCost": "Under $500",
"budgetTier": "under-1k",
"timeToFirstDollar": "Depends on the idea you attach it to",
"timeBand": "under-30",
"difficulty": "Beginner",
"revenuePotential": "High",
"viability": 9.5,
"traits": [
"Beginner friendly",
"Low startup cost",
"Fast launch",
"Local business"
],
"location": "Hybrid",
"audience": "Both",
"businessType": "Service",
"topics": [
"First business",
"Legal",
"Setup"
],
"profitMargin": "Not applicable, this is the foundation layer",
"bestFor": "Everyone starting anything on this site",
"howToStart": "Decide what you will sell, pick your structure, get the free EIN from the IRS, open a separate business bank account, and go get the first customer.",
"whyOverlooked": "Nothing about starting a business is overlooked; hundreds of thousands of people search it every month. Most never start because the legal steps feel bigger than they are, so they research for months when the paperwork is an afternoon and the real work is the first sale.",
"professions": [],
"identities": [
"Students",
"Parents",
"Career changers",
"Corporate escapees",
"Retirees",
"Veterans",
"Immigrants"
],
"ages": [
"Teens",
"Adults",
"50 plus"
],
"trending": false,
"addedAt": "2026-07-02",
"steps": [
{
"title": "Choose the thing you will sell and prove someone wants it",
"detail": "A business is not an LLC; it is a paying customer. Before any paperwork, write one sentence: who you serve, what problem you solve, and what they pay. Then test it cheap: ask five real people in that group if they would buy at that price, or better, take one pre-order. If nobody bites, you just saved yourself the filing fee."
},
{
"title": "Pick your structure honestly, then register it properly",
"detail": "A sole proprietorship is the default the moment you sell something under your own name, but default is not the same as done right: your personal assets stand behind every business debt and lawsuit, and most cities and states still expect a DBA name filing or a local license before you operate. An LLC costs a state filing fee (roughly $35 to $500 depending on the state) and puts a legal wall between the business and your house; if your work carries physical risk, contracts, or clients on premises, form it before the first job. Whichever you choose, make it official with your state: the guide at /register-a-business shows your state's real fee and the official office to file with."
}
],
"whatItIs": "This is the one path every business on this site eventually walks, whatever the idea: decide what you will sell, confirm someone will pay for it, choose a legal structure, get the free EIN, open a business bank account, handle the licenses your city and industry require, and land the first customer. It is deliberately not tied to any single idea, because it is the foundation layer under all of them. It runs online, in person, or both, and for most first businesses the whole legal and financial setup costs under $500 and takes days, not months. The paperwork is the easy part; the discipline of validating before filing and selling before polishing is the real skill being taught here.",
"whyItWorks": "The foundations work because they are the same everywhere: an entity, an EIN, a separate bank account, and a first sale are what a dog walker, a consultant, and a software founder all need, in the same order. Done early, they compound: the entity protects your personal assets before a problem exists, the separate account makes taxes and pricing honest, and the first-customer discipline forces contact with reality while changing course is still cheap. Done late or never, each one becomes expensive exactly when you can least afford it: commingled money in a dispute, an unlicensed sale in a regulated trade, a year of work priced below cost. The people who treat setup as a one-week project and selling as the main event are the ones still in business a year later.",
"whatYouNeed": [
{
"item": "One sentence that says who pays you, for what",
"why": "Every later decision (entity, license, price, marketing) flows from this. If you cannot say it plainly, you are not ready to file anything yet."
}
],
"mistakes": [
{
"mistake": "Researching for months instead of filing and selling",
"consequence": "The window where motivation is highest gets spent on tabs and videos, and most people in this loop never start at all"
}
],
"monetizationPaths": [
{
"path": "Sell a service",
"how": "Your time and skill for money: cleaning, consulting, design, care, trades. The fastest first dollar of any model because there is nothing to build first; most ideas on this site start here."
}
],
"firstSevenDays": [
{
"day": "Day 1",
"action": "Write the one-sentence business: who you serve, what you solve, what they pay. Pick the idea on this site it attaches to."
}
],
"notFor": "Not for people looking for a specific business idea; this card is the setup underneath the idea, so pick one from the site first or bring your own. Not for anyone hoping the paperwork will substitute for selling; an LLC with no customers is a fee, not a business. And not for people who want someone else to decide for them whether to start. This path assumes the decision is made and gets you legal, banked, and paid.",
"faq": [
{
"q": "How much does it really cost to start a business?",
"a": "Less than the fear says. Registering properly costs a state filing fee, roughly $35 to $500 for an LLC depending on your state, the EIN is free from the IRS, and a license or DBA filing where your city or industry requires one adds a little more. Most people on this site are fully set up for under $500, and your state's guide at /register-a-business lists the real fee and the official office. The bigger number is the startup cost of your specific idea, which the calculators on this platform help you estimate before you spend it."
}
],
"revenueEstimate": {
"monthlyLowUsd": 500,
"monthlyHighUsd": 6000,
"model": "mixed",
"basis": "As foundational education or coaching, income comes from courses and sessions and builds slowly with audience."
}
}
}Arrays are trimmed here for display; the live endpoint returns every step, mistake, and monetization path the card carries.
Categories and facets
GET /api/v1/idea-bank/categories returns every facet value with its live count: categories, industries, budget tiers, time bands, difficulties, audiences, and business types. Use it to build filter UIs and to discover valid filter values for the list endpoint.
{
"data": {
"categories": [ { "value": "Local Services", "count": 412 }, ... ],
"industries": [ { "value": "Healthcare", "count": 388 }, ... ],
"budgetTiers": [ { "value": "under-1k", "count": 1834 }, ... ],
"timeBands": [ ... ],
"difficulties": [ ... ],
"audiences": [ ... ],
"businessTypes": [ ... ]
}
}Curated lists
GET /api/v1/idea-bank/lists returns all 65 curated lists (slug, title, group, blurb, and live count). GET /api/v1/idea-bank/lists/{slug}returns one list with its member ideas as summaries, in the list's own curated order.
curl
curl -H "Authorization: Bearer uyi_live_YOUR_KEY" \ "https://www.unleashyourideas.com/api/v1/idea-bank/lists" curl -H "Authorization: Bearer uyi_live_YOUR_KEY" \ "https://www.unleashyourideas.com/api/v1/idea-bank/lists/ready-to-launch-businesses"
Meta
GET /api/v1/idea-bank/meta returns the catalog size, the API version, and this docs URL. Handy as a connectivity and key check.
{
"data": {
"version": "v1",
"ideas": 5043,
"lists": 65,
"revenueEstimates": 1200,
"docsUrl": "https://www.unleashyourideas.com/ideas-api/docs"
}
}The live numbers grow as approved ideas join the catalog, so treat these values as a snapshot.
Changelog
- v1 (August 2026). Initial release: ideas list with filters, search, and sorting; single-idea detail with steps and researched revenue estimates; categories with counts; curated lists; meta.
Ready to build?

