Skip to main content

​
Overview

Result Analysis records contain the processed outcomes of your cached job executions. Each analysis provides insights into how AI models mention and describe your brand in their responses.

​
Result Analysis Properties

PropertyTypeDescription
idstring (UUID)Unique identifier
cachedJobstring (UUID)Associated cached job ID
timestringTimestamp of the analysis
analysisResultobjectStructured analysis data
sourcesAnalysisResultobjectSource attribution data
updatedAtstringLast update timestamp

​
Analysis Result Structure

The analysisResult object contains detailed metrics about brands mentioned in the AI response: 
{
  "model": "gpt-4.1-mini",
  "object": {
    "brands": [
      {
        "name": "Acme Corp",
        "mentioned": true,
        "mention_count": 1,
        "sentiment_score": 80,
        "ranking_position": 1
      },
      {
        "name": "TechFlow Solutions",
        "mentioned": true,
        "mention_count": 1,
        "sentiment_score": 75,
        "ranking_position": 2
      },
      {
        "name": "CloudBase",
        "mentioned": true,
        "mention_count": 1,
        "sentiment_score": 70,
        "ranking_position": 3
      }
    ]
  },
  "executionKey": "gpt-4o-mini:0",
  "analysisModel": "gpt-4o-mini",
  "executionNumber": 0
}

​
Top-Level Fields

FieldTypeDescription
modelstringThe AI model that generated the response
objectobjectContains the brands analysis data
executionKeystringUnique key combining model and execution number
analysisModelstringThe model used to analyze the response
executionNumbernumberIteration number within the execution batch

​
Brand Object Fields

FieldTypeDescription
namestringName of the detected brand
mentionedbooleanWhether the brand was mentioned
mention_countnumberNumber of times the brand was mentioned
sentiment_scorenumberSentiment score (0-100)
ranking_positionnumberPosition in the AI response ranking

​
Sources Analysis

The sourcesAnalysisResult tracks which sources AI models cited when mentioning your brand. Each key is a URL that was cited, with details about whether your brand was found and the context of each mention: 
{
  "https://example.com/article/top-tools-2024?utm_source=openai": {
    "found": true,
    "matches": [
      {
        "text": "Acme Corp",
        "context": "leading platforms include Acme Corp — European self‑service",
        "position": 1738
      },
      {
        "text": "Acme Corp",
        "context": "UI and fast local buys. (acmecorp.com)\n\n6. TechFlow — glob",
        "position": 1981
      },
      {
        "text": "Acme Corp",
        "context": "campaigns: platforms like Acme Corp make setup and creative",
        "position": 3366
      }
    ],
    "subDomain": null,
    "rootDomain": "example.com"
  },
  "https://news-site.com/industry-report?utm_source=openai": {
    "found": false,
    "matches": [],
    "subDomain": null,
    "rootDomain": "news-site.com"
  }
}

​
Source Object Fields

FieldTypeDescription
foundbooleanWhether your brand was found in the cited source
matchesarrayList of brand mentions found in the source
subDomainstring | nullSubdomain of the source URL
rootDomainstringRoot domain of the source URL

​
Match Object Fields

FieldTypeDescription
textstringThe matched brand name text
contextstringSurrounding text providing context for the mention
positionnumberCharacter position of the match in the source content
Use time-based filtering to analyze trends in your brand visibility: 
curl -X POST "https://api.mentionlab.io/api/result-analysis/list" \
  -H "x-api-key: ml_live_abc123xyz789..." \
  -H "x-organisation-id: YOUR_ORG_ID" \
  -H "x-project-id: YOUR_PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "YOUR_PROJECT_ID",
    "timeFrom": "2024-01-01T00:00:00Z",
    "timeTo": "2024-01-31T23:59:59Z"
  }'

​
Best Practices

Set up daily or weekly recurrence to track changes in your brand visibility over time.
Tag your queries to easily filter and compare results across different categories (competitors, features, regions).
Analyze results from different AI providers to understand where your brand has the strongest presence.

Cached Jobs

Learn about the jobs that generate these analysis results.

Tags

Organize your queries and filter results with tags.