Perplexity brand visibility report API

Price: 3 credits per request

Description: Use the Perplexity brand report API to uncover how Perplexity AI understands your brand, measuring brand awareness, sentiment, credibility, and how accurately it links your products and services

Query string parameters

Name Parameter Description
Brand input &brandinput=

Enter either your brand name or brand URL

example: Nike
Key &key= Your private API key

Response elements

Name Type Description
brand_name string Name of the analyzed brand
brand_description string Brand description
company_url string (URL) Official brand website URL
brand_awareness_category string Category describing brand awareness (e.g., Iconic, Recognized)
brand_awareness_score integer string Numerical score representing brand awareness
brand_awareness_sources array Sources contributing to brand awareness
sentiment_analysis object Sentiment analysis data
sentiment_analysis.sentiment_category string Overall sentiment classification (e.g., Positive)
sentiment_analysis.sentiment_information string Explanation or supporting info for the sentiment
credibility object Credibility analysis data
credibility.credibility_category string Category of credibility (e.g., High, Medium)
credibility.credibility_information string Explanation behind the credibility rating
credibility.credibility_score integer string Numerical credibility score
services_products array List of products or services related to the brand
top_5_keywords array Top keywords associated with the brand
related_prompts array Prompts related to the brand
top_5_competitors array List of top competitor brands

Perplexity – Brand visibility score

This overview shows how you should interpret the Brand visibility score returned by the API.

Category Description
Iconic Widely recognized on a global scale, with strong brand loyalty and frequent media mentions.
Well-known Familiar to a broad audience, especially within its industry or regional market.
Recognized Known among a specific niche or professional audience but not yet mainstream.
Emerging / Unknown Limited brand visibility or still gaining awareness among target audiences.

PHP code example

<?php

/*
    API documentation for SEO Review Tools.
    API info: https://www.seoreviewtools.com/seo-api/
    API documentation: https://api.seoreviewtools.com/documentation/
    LinkedIn: https://www.linkedin.com/company/seo-review-tools
*/

// API key 
$apiKey = 'YOUR-API-KEY';

// Brand input
$brandinput = "Nike"; 

// specific API url 
$apiRequestUrl = 'https://api.seoreviewtools.com/perplexity-brand-research/?brandinput='.urlencode($brandinput).'&key='.$apiKey;

// get data from API
$jsonReposnse = file_get_contents($apiRequestUrl);

// convert JSON to PHP array
$dataArray = json_decode($jsonReposnse, true);

// check if API call is success or failed
// (just some basic validation)

// API call fail
if ($dataArray['status'] !== 'ok'){

    // return error message
    echo 'Error message: '.$dataArray['error message'];

// API call success    
} else {

    // print data
    print_r($dataArray); 
}

?> 

cURL code example

curl -G "https://api.seoreviewtools.com/perplexity-brand-research/" \
  --data-urlencode "brandinput=Nike" \
  --data-urlencode "key=YOUR-API-KEY"

Python code example

import requests
import urllib.parse

# API key
api_key = 'YOUR-API-KEY'

# Brand input
brand_input = "Nike"

# Encode brand input for URL
encoded_brand = urllib.parse.quote(brand_input)

# Build request URL
api_url = f"https://api.seoreviewtools.com/perplexity-brand-research/?brandinput={encoded_brand}&key={api_key}"

# Make the GET request
response = requests.get(api_url)

# Try parsing the JSON
try:
    data = response.json()
except ValueError:
    print("Failed to decode JSON response.")
    exit()

# Check API status
if data.get("status") != "ok":
    print("Error message:", data.get("error message", "Unknown error"))
else:
    # Print the result data
    print(data)

JSON response example






Trusted by →

clients