POST
/lists/ai-generateAI-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://www.google.com/s2/favicons?domain=anomalabs.com&sz=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