Generate Insights

👋
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 or contactLinkedinUrl

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": "henry@zoominfo.com"
}

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": "henry@zoominfo.com",
    "insightSubtype": "socialMediaProspectRecentLinkedInPosts"
}

Example: Multiple Subtypes

data = {
    "contactEmail": "henry@zoominfo.com",
    "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