Skip to main content

Get Mentions

This tutorial shows you how to retrieve mentions/posts that match the keywords you are monitoring after a project has been created.

Prerequisites​

  • ✅ A project already created (see Create Projects Tutorial)
  • ✅ A valid authentication token
  • ✅ The project ID for the project you want to query

Step 1: Retrieve all mentions​

Fetch all mentions for a given project. Copy the project ID you created earlier and use it in your request.

📖 Full Mentions API documentation

Sample response

{
  "data": [
    {
      "id": "mention_id",
      "targeted_account_id": "targeted_account_id",
      "content": "content",
      "keywordid": "proejct_id",
      "url": "mention_url",
      "sentimen": null,
      "socialmediaid": "facebook",
      "createdat": "2026-03-18T01:33:47Z",
      "updated_at": "0001-01-01T00:00:00Z",
      "targeted_account": {
        "username": "account_username",
        "display_name": "account_name"
      },
      "SnaKeyword": {
        "group": "group_name",
        "keyword": "keyword"
      }
    },
    {
      ...
    },
  ],
  "total": 43,
  "page": 1,
  "limit": 10,
  "totalPages": 5
}

Understanding the response data​

Mention object​

  • id: Unique identifier for the mention
  • targeted_account_id: ID of the account that posted the mention
  • content: The text/content of the mention/post
  • keywordid: ID of the keyword that matched this mention
  • url: source of the mention
  • sentimen: Sentiment score (0: neutral, 1: positive, 2: negative)
  • socialmediaid: Identifier of the social media platform
  • createdat: Time the mention was created (ISO 8601 format)
  • updated_at: Last update time for this record

SnaKeyword object​

  • group: Project name (parent group of the keyword)
  • keyword: Keyword used for monitoring

targeted_account object​

  • display_name: Full display name of the account
  • username: Handle/username of the account

Next steps​

After you retrieve mentions, you can:

  1. Generate a summary → Use the AI Service to create an overview
  2. Export data → Export mentions for reporting (from the web UI)

📖 Full Mentions API documentation 📖 Project Summary Tutorial

Troubleshooting​

Common issues​

Empty response

  • Make sure scraping has been started for the project
  • Check whether the keyword is relevant enough to return data
  • Verify that the date range used is not too narrow

401 Unauthorized

  • Confirm that your token is still valid
  • Refresh the token if it has expired

429 Too Many Requests

  • Add a delay between requests
  • Use batch processing when calling multiple requests