Quick start
Get up and running in under 5 minutes. First, create an account and generate an API key from your dashboard.
Make your first request
# Look up a professional by their profile slug
curl https://www.brokenwindow.ai/api/v1/profile/ted-pick-financia \
-H "Authorization: Bearer bw_live_your_api_key_here"{
"success": true,
"data": {
"slug": "ted-pick-financia",
"name": "Ted Pick",
"title": "CEO",
"company": "Morgan Stanley",
"clout": {
"score": 8.2,
"label": "Well Connected",
"notable_facts": [
"CEO and Chairman of Morgan Stanley since January 2024",
"34-year Morgan Stanley veteran who rose from analyst to CEO"
],
"awards": [
"Fortune 100 Most Powerful People in Business (2025)"
]
},
"references": {
"count": 0,
"avg_rating": null,
"rehire_pct": null
},
"url": "https://www.brokenwindow.ai/profile/ted-pick-financia"
}
}Authentication
All API requests require a valid API key. Pass your key using the Authorization header:
Authorization: Bearer bw_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAPI keys start with bw_live_ and are 56 characters long. Keep your key secret — treat it like a password.
🔑 Generate your API key
Log in to your Broken Window account, go to Dashboard → API Keys, and click "Generate new key". The full key is shown only once.
Rate limits
| Plan | Daily requests | Cost |
|---|---|---|
| Subscriber included | 100 / day | Included with subscription |
| Pro API coming soon | 5,000 / day | $49/month |
Daily limits reset at midnight UTC. Daily limits reset at midnight UTC automatically. Rate limit headers are included in every response:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 94
X-RateLimit-Reset: 2026-04-09T00:00:00ZError codes
| Status | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 404 | Profile not found |
| 429 | Daily rate limit exceeded |
| 400 | Invalid request parameters |
| 500 | Server error — try again |
Endpoints
Returns full profile data including clout score, notable facts, awards, and reference stats for a professional.
Path parameters
| Parameter | Type | Description |
|---|---|---|
| slugrequired | string | The profile's URL slug (e.g. ted-pick-financia) |
curl https://www.brokenwindow.ai/api/v1/profile/jamie-dimon-financia \
-H "Authorization: Bearer bw_live_your_key"Search professionals by name, company, or job title. Returns up to 50 results ordered by reference count and clout score.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| qrequired | string | Search query (min 2 characters). Searches name, company, and title. |
| limitoptional | integer | Max results to return. Default: 10, max: 50. |
curl "https://www.brokenwindow.ai/api/v1/search?q=Jamie+Dimon&limit=5" \
-H "Authorization: Bearer bw_live_your_key"Returns professionals ranked by clout score. Use min_score to filter by minimum score.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| limitoptional | integer | Max results. Default: 20, max: 100. |
| min_scoreoptional | float | Minimum clout score filter (0-10). Default: 0. |
curl "https://www.brokenwindow.ai/api/v1/leaderboard?min_score=8&limit=10" \
-H "Authorization: Bearer bw_live_your_key"Manage API keys
API keys can be generated and revoked from your dashboard. You can also use the API endpoints below.
Generate a new API key. Requires an active session (must be logged in).
curl -X POST https://www.brokenwindow.ai/api/v1/keys/generate \
-H "Content-Type: application/json" \
-d '{"name": "My App"}' \
--cookie "session=your_session_cookie"List all your API keys (prefixes only — full keys are never stored).
Revoke an API key immediately.