Developer
Build with Happenstance and manage API access and usage.
Quickstart
Get started with the Happenstance API.
1
Create API key
You'll need an API key to authenticate your requests.
2
Submit request
Returns a search ID.
curl -X POST https://api.happenstance.ai/v1/search \
-H "Authorization: Bearer $YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Software engineers in San Francisco",
"include_friends_connections": true,
"include_my_connections": true
}'3
Get search results
Can take a few minutes to complete.
curl -X GET https://api.happenstance.ai/v1/search/$SEARCH_ID \
-H "Authorization: Bearer $YOUR_API_KEY"4
(Optional) Continue search
Get additional results.
curl -X POST https://api.happenstance.ai/v1/search/$SEARCH_ID/find-more \
-H "Authorization: Bearer $YOUR_API_KEY"