Submit a Startup
POST/startups/submit

Submit a Startup

Agent-friendly endpoint that lets an AI agent (or any API client) submit a new startup for inclusion on StartupHub.ai. Submissions enter a moderation queue and become public after admin approval (typically within 24h). Strict format: third-person prose, no HTML/markdown, no listicle titles. On bad input returns 400 with field-level errors and copy-paste suggestions so the agent can self-correct without human help. Optional logo_url is fetched and stored automatically (≤2MB).

POSThttps://www.startuphub.ai/api/v1/startups/submit

Request

curl -X POST "https://www.startuphub.ai/api/v1/startups/submit" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Anthropic",
    "website": "https://anthropic.com",
    "one_liner": "Anthropic builds reliable, interpretable, and steerable AI systems for the safety-conscious enterprise.",
    "description": "Anthropic is an AI safety company building large-scale language models with a focus on reliability and interpretability. Founded in 2021 by former OpenAI executives, the company researches techniques for making AI systems more honest, harmless, and helpful. Anthropic offers Claude, an enterprise-grade chat assistant, alongside research APIs.",
    "sectors": ["Artificial Intelligence", "AI Research"],
    "founded_date": "2021",
    "hq_country": "United States",
    "hq_city": "San Francisco",
    "logo_url": "https://anthropic.com/logo.png"
  }'

Parameters

namestringrequired

Official company name (≤80 chars; no listicle words like "best/top/2026")

websitestringrequired

Company website URL

one_linerstringrequired

One-sentence pitch in third person, 20–200 chars

descriptionstringrequired

Full description in third person, 30–400 words, plain text only

sectorsarrayrequired

1–5 sectors from the controlled vocabulary

founded_datestringoptional

YYYY, YYYY-MM, or YYYY-MM-DD

hq_countrystringoptional

Country

hq_citystringoptional

City

linkedin_urlstringoptional

Company LinkedIn URL

twitter_urlstringoptional

Company Twitter/X URL

github_urlstringoptional

Company GitHub URL

logo_urlstringoptional

Optional logo image URL — server fetches and stores (≤2MB, PNG/JPEG/WebP/SVG/GIF)

stagestringoptional

Pre-seed | Seed | Series A/B/C/D | Series E+ | Growth | Late Stage | Pre-IPO | Public | Acquired | Bootstrapped

business_modelstringoptional

B2B SaaS | B2C SaaS | Marketplace | API/Developer Tools | Hardware | ...

employee_countnumberoptional
total_fundingnumberoptional

USD

latest_funding_roundstringoptional

e.g. "Series B"

latest_funding_datestringoptional

YYYY or YYYY-MM-DD

latest_valuationnumberoptional

USD

stock_exchangestringoptional

NASDAQ | NYSE | ... — for public companies

tickerstringoptional
linkedin_followersnumberoptional
github_starsnumberoptional
former_namesarrayoptional

Previous company names

facebook_urlstringoptional
youtube_urlstringoptional
blog_urlstringoptional
substack_urlstringoptional
discord_urlstringoptional
slack_urlstringoptional
community_urlstringoptional
status_urlstringoptional
changelog_urlstringoptional
roadmap_urlstringoptional
api_docs_urlstringoptional
security_page_urlstringoptional
demo_urlstringoptional
demo_video_urlstringoptional
coding_languagesarrayoptional

e.g. ["Python", "TypeScript", "Rust"]

frameworks_toolsarrayoptional
cloud_providersarrayoptional

e.g. ["AWS", "GCP"]

certificationsarrayoptional

SOC 2 | SOC 2 Type II | ISO 27001 | HIPAA | GDPR | PCI DSS | FedRAMP | ...

is_raisingbooleanoptional
raising_roundstringoptional
raising_targetnumberoptional

USD

raising_use_of_fundsstringoptional
pitch_deck_urlstringoptional
is_hiringbooleanoptional
careers_urlstringoptional
contact_emailstringoptional
partnerships_emailstringoptional
press_emailstringoptional
foundersarrayoptional

Array of { name, role, linkedin_url, email } — matched to existing people by slug / name / LinkedIn; unmatched stashed in admin review queue

team_membersarrayoptional

Same shape as founders

notable_investorsarrayoptional

Array of { name, slug, website } — matched to existing investors

competitorsarrayoptional

Array of { name, slug, website } — matched to existing startups

mentioned_articlesarrayoptional

Array of { slug } or { url } — links to StartupHub.ai posts; bidirectional

productsarrayoptional

Array of { name, description, url } — stashed in meta_fields for admin promotion

Response

json
{
  "success": true,
  "status": "pending_review",
  "message": "Submission received. An admin will review within 24 hours. The profile is not publicly visible until approved.",
  "startup": {
    "id": "uuid",
    "slug": "anthropic",
    "name": "Anthropic",
    "url": "https://www.startuphub.ai/startups/anthropic",
    "moderation_status": "flagged_pending",
    "logo_url": "https://bsmromhjxdnndenlrpgx.supabase.co/storage/v1/object/public/entity-images/startups/uuid.png"
  },
  "credits": { "used": 5, "limit": 100, "remaining": 95 }
}

Errors

400validation_failed — response includes errors[] with field, message, suggestion
409duplicate — a profile with this website domain already exists
429rate_limit — daily/monthly credit cap reached
PreviousCompany Technology StackNext Search Investors