POST
/lists/ai-generate5 creditsAI-Generated Startup Lists
Prompt → curated list of matching startups. Pass a natural-language brief ("stealth AI agent startups in Israel founded after 2024") and the engine runs a Google-grounded search, parses the results, finds or creates the matching startup rows, and returns up to 50 IDs you can hand to /lists/submit to publish. Pair with /v1/lists/submit for a complete prompt-to-public-list workflow. Each call: 5 credits.
POSThttps://www.startuphub.ai/api/v1/lists/ai-generate
Request
curl -X POST "https://www.startuphub.ai/api/v1/lists/ai-generate" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "stealth AI agent startups in Israel founded after 2024",
"limit": 15
}'Parameters
promptstringoptionalNatural-language brief - required unless pasted_list is provided
pasted_liststringoptionalRaw text (YC batch page, a16z portfolio, CSV, article). Names + context extracted automatically.
typestringoptionaldefault: startupEntity type - only "startup" supported today
limitintegeroptionaldefault: 20Max suggestions to return (1-50)
Response
json
{
"data": {
"found": [
{
"id": "uuid",
"name": "Anoma Labs",
"slug": "anoma-labs",
"logoUrl": "https://t2.gstatic.com/faviconV2?client=SOCIAL&type=FAVICON&fallback_opts=TYPE,SIZE,URL&url=https://anomalabs.com&size=128"
}
],
"total_suggestions": 18,
"matched": 15,
"created": 3
},
"credits": { "used": 5, "limit": 15, "remaining": 10 }
}
// Pipe data.found[].id into POST /lists/submit to publish the
// curated list as a public page on StartupHub.ai.Errors
400Both prompt and pasted_list missing, or type !== "startup"429Daily / monthly cap hit, OR per-user 10-call-per-10-minute burst limit502AI returned no usable results (try a more specific prompt)504Gemini timeout - retry with simpler prompt