Prerequisites
Before you begin, make sure you have:Make Your First Request
1. Research a Person
Generate a detailed profile:Copy
curl -X POST https://api.happenstance.ai/v1/research \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "Garry Tan Y Combinator"
}'
Copy
{
"id": "547e404b-0129-4400-b42d-038cca184414"
}
View the research profile at:
https://happenstance.ai/research/{id}Research generation takes 1-3 minutes. The page will update automatically when complete.2. Poll for Completion
Research runs asynchronously. Poll the GET endpoint until the status isCOMPLETED:
Copy
curl -X GET https://api.happenstance.ai/v1/research/ \
-H "Authorization: Bearer YOUR_API_KEY"
Copy
{
"id": "547e404b-0129-4400-b42d-038cca184414",
"status": "RUNNING",
"query": "Garry Tan Y Combinator",
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T10:30:05Z",
"profile": null
}
Copy
{
"id": "547e404b-0129-4400-b42d-038cca184414",
"status": "COMPLETED",
"query": "Garry Tan Y Combinator",
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T10:32:15Z",
"profile": {
"person_metadata": {
"full_name": "Garry Tan",
"alternate_names": [],
"profile_urls": [
"https://www.ycombinator.com/people/garry-tan",
"https://x.com/garrytan",
"https://www.linkedin.com/in/garrytan"
],
"current_locations": [
{
"location": "San Francisco, California",
"urls": ["https://www.forbes.com/profile/garry-tan/"]
}
],
"tagline": "President and CEO of Y Combinator, entrepreneur, and investor"
},
"employment": [
{
"company_name": "Y Combinator",
"job_title": "President and CEO",
"start_date": "2022",
"end_date": null,
"description": "Leads Y Combinator, the world's most successful startup accelerator, guiding strategy and operations for the organization that has funded over 4,000 startups.",
"urls": ["https://www.ycombinator.com/people/garry-tan"]
},
{
"company_name": "Initialized Capital",
"job_title": "Co-Founder and Board Partner",
"start_date": "2011",
"end_date": null,
"description": "Co-founded early-stage venture capital firm with Alexis Ohanian, investing in companies like Coinbase, Instacart, and Flexport.",
"urls": ["https://initialized.com/"]
},
{
"company_name": "Y Combinator",
"job_title": "Partner",
"start_date": "2011",
"end_date": "2015",
"description": "Served as a YC partner, mentoring and investing in early-stage startups."
},
{
"company_name": "Palantir Technologies",
"job_title": "Early Employee, Designer & Engineer",
"start_date": "2008",
"end_date": "2008",
"description": "Early employee contributing to design and engineering on the founding team."
}
],
"education": [
{
"university_name": "Stanford University",
"degree": "B.S. Computer Systems Engineering",
"end_date": "2003",
"description": "Studied computer systems engineering at Stanford University."
}
],
"projects": [
{
"title": "Posthaven",
"description": "Continuation of Posterous as a sustainable blogging platform after the Twitter acquisition.",
"start_date": "2013"
},
{
"title": "Garry Tan YouTube Channel",
"description": "Educational content for founders on product, hiring, and fundraising.",
"start_date": "2020"
}
],
"summary": {
"text": "Garry Tan is a prominent Silicon Valley entrepreneur, investor, and the current President and CEO of Y Combinator. He has played a pivotal role in shaping the startup ecosystem through his work at YC and as co-founder of Initialized Capital, where he made early investments in companies that became worth over $100 billion combined.\n\nTan's career spans founding startups, venture investing, and startup mentorship. He was a founding team member at Palantir Technologies and co-founded Posterous. His deep technical background as an engineer and designer, combined with his investing experience, gives him a unique perspective on building and scaling startups.",
"urls": [
"https://www.ycombinator.com/people/garry-tan",
"https://www.forbes.com/profile/garry-tan/",
"https://x.com/garrytan"
]
}
}
}
Poll every 5-10 seconds. Research typically completes within 1-3 minutes.
Status can be
RUNNING, COMPLETED, FAILED, or FAILED_AMBIGUOUS.