AI-Generated Startup Lists
POST/lists/ai-generate

AI-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

promptstringoptional

Natural-language brief — required unless pasted_list is provided

pasted_liststringoptional

Raw text (YC batch page, a16z portfolio, CSV, article). Names + context extracted automatically.

typestringoptionaldefault: startup

Entity type — only "startup" supported today

limitintegeroptionaldefault: 20

Max 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 limit
502AI returned no usable results (try a more specific prompt)
504Gemini timeout — retry with simpler prompt