Submit a Startup
POST/startups/submit5 credits

Submit a Startup

Agent-friendly endpoint that lets an AI agent (or any API client) submit a new startup. A website is enough. Name, description, and sectors are optional. If you send only a website, the profile is listed on the free plan and the rest is filled in from that site. Gambling and adult content stay hidden. When you send prose: third person, 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. 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

namestringoptional

Official company name. Optional. If omitted, the name is taken from the website.

websitestringrequired

Company website URL. This is the only required field.

one_linerstringoptional

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

descriptionstringoptional

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

sectorsarrayoptional

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": "listed",
  "message": "Listed on the free plan. Upgrade is optional from the profile editor.",
  "startup": {
    "id": "uuid",
    "slug": "anthropic",
    "name": "Anthropic",
    "url": "https://www.startuphub.ai/startups/anthropic",
    "moderation_status": "published",
    "payment_status": "free",
    "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
PreviousScore MoversNext Company Technology Stack