Generate Insights
Get detailed insights on any professional contact using just their email address or LinkedIn URL. Consumes 1 credit.
Do you plan on writing sales content using these insights?
If so, we suggest you use our
[generate-content](https://autobound-api.readme.io/docs/generating-content#/)
endpoint (which performs the same insight resolution then writes the content, and let's you pass in your own data).
Use the generate-insights
API to pull rich, research-grade insights on any prospect using just their email address or LinkedIn URL. You'll get up to 350+ data signals including:
- Work history
- Social media activity
- Podcast mentions
- News coverage
- Financial signals
- Hiring trends
- And much more
📘 Full list of supported subtypes: View Subtypes
🔝 Generate Top 20 Ranked Insights
If you don’t specify the insightSubtype
parameter, the API will return the top 20 most relevant insights based on the prospect and/or company.
✅ Minimum Required:
contactEmail
orcontactLinkedinUrl
Example
import requests
url = 'https://api.autobound.ai/api/external/generate-insights/v1.2'
headers = {
'X-API-KEY': 'YOUR-API-KEY-HERE',
'Content-Type': 'application/json'
}
data = {
"contactEmail": "[email protected]"
}
response = requests.post(url, headers=headers, json=data)
print(response.text)
Sample Response (Top 20 Ranked)
{
"insights": [
{
"name": "Negative quarterly revenue growth",
"subType": "negativeGrowth",
"type": "financial",
"variables": {
"quarterlyRevenueGrowthYOY": "-5.50%",
"title": "Negative quarterly revenue growth",
"financialContent": "Last quarter's YOY quarterly revenue growth was -5.50%. When this dips below zero, it may signal declining sales or market share..."
}
},
{
"name": "Appeared in podcast",
"subType": "podcast",
"type": "socialMedia",
"variables": {
"title": "Henry Schuck on ZoomInfo’s Journey",
"snippet": "CEO of ZoomInfo shares insights on scaling a B2B data platform...",
"website": "https://podcasts.apple.com/..."
}
}
// ...up to 20 total
]
}
🎯 Generate Insights by Specific Subtype(s)
To return only specific types of insights, use the insightSubtype
parameter.
Supported:
- Single string
- Array of strings (up to 10 subtypes)
Example: One Subtype
data = {
"contactEmail": "[email protected]",
"insightSubtype": "socialMediaProspectRecentLinkedInPosts"
}
Example: Multiple Subtypes
data = {
"contactEmail": "[email protected]",
"insightSubtype": ["socialMediaLinkedinAboutMe", "socialMediaProspectRecentLinkedInPosts", "newsNewCustomer"]
}
Sample Response
{
"insights": {
"socialMediaLinkedinAboutMe": [
{
"name": "LinkedIn About Me",
"subType": "socialMediaLinkedinAboutMe",
"variables": {
"aboutMe": "Henry Schuck is the founder and CEO of ZoomInfo, a go-to-market intelligence platform used by 30,000+ companies."
}
}
],
"socialMediaProspectRecentLinkedInPosts": [
{
"name": "LinkedIn Post",
"subType": "socialMediaProspectRecentLinkedInPosts",
"variables": {
"postUrl": "https://linkedin.com/posts/example1",
"first500CharactersOfPost": "It’s 1983. You’re Michael Dell. And you figured out Signal-Based Selling..."
}
},
{
"name": "LinkedIn Post",
"subType": "socialMediaProspectRecentLinkedInPosts",
"variables": {
"postUrl": "https://linkedin.com/posts/example2",
"first500CharactersOfPost": "Let’s say you only had 15 minutes to prepare for a customer meeting..."
}
}
],
"newsNewCustomer": [
{
"name": "New customer announcement",
"subType": "newsNewCustomer",
"variables": {
"insightTitle": "ZoomInfo Selected by Acme Corp",
"insightUrl": "https://news.example.com/zoominfo-acme",
"publishDate": "2024-08-01",
"insightBody": "ZoomInfo announced a new partnership with Acme Corp to power its global GTM strategy."
}
}
]
}
}
⚙️ Behavior Summary
Scenario | Behavior |
---|---|
No insightSubtype | Returns up to 20 ranked insights (varied subtypes) |
Single insightSubtype | Returns up to 5 insights of that subtype |
Array of insightSubtype s | Returns up to 2 insights per subtype, max 10 subtypes per request |
Invalid subtype(s) | Request fails entirely with error message |
No data for a valid subtype | Empty array returned + message in errors block |
Updated 6 days ago