Skip to main content

Project Summary

This tutorial shows you how to generate and retrieve AI summaries for mentions collected by a project.

Prerequisites​

  • ✅ A project has been created (see Create Projects Tutorial)
  • ✅ Scraping has been run and mentions are available
  • ✅ You have the project ID whose mentions you want to analyse
  • ✅ You have a valid authentication token

Generate a summary for project keywords​

Use the project ID to generate an automatic AI summary for all mentions associated with that project.

📖 Full Project Summary API docs

Retrieve an existing summary​

If a summary has already been generated before, you can fetch it without running the generation again.

📖 Full Project Summary API docs

Tips & Best Practices​

When to generate a summary​

  • Generate a summary after there are enough mentions (at least 20+)
  • Regenerate if there is a significant amount of new mentions
  • Summaries are most useful for weekly or monthly analysis

Optimizing summary quality​

  • Summaries work best for keywords with a reasonably high volume
  • Group related keywords into the same project for better context

Complete workflow​

  1. Create Project → Create a project with the desired keywords
  2. Run Scraping → Collect mentions from social media
  3. Get Mentions → Retrieve mention data for analysis
  4. Generate Summary → Create an AI‑powered summary from the mentions

Troubleshooting​

Common issues​

404 Keyword or project not found

  • Make sure the keyword ID and project ID are valid
  • Check that mentions already exist for the given keyword/project
  • Verify that the keyword is still active in the project

Processing timeout

  • Summary generation can take time for high‑volume projects
  • Wait a moment before retrying
  • Check API status or logs if delays are persistent