AI Brand Visibility Report

RankLens

Measure AI brand visibility — how often and how prominently a brand surfaces in generative engine answers — and benchmark it against competitors.

POSThttps://ai.seovendor.co/api/ranklens/

Authenticate every request by passing your secret key as k in the JSON body. Requests are POST with Content-Type: application/json.

01Request parameters

Field	Type	Required	Description
action	string	optional	rank Generate RankLens report.competitors Find RankLens competitors.
mgptid	string	required	Encrypted MGPTID, required for competitors action.
MGPTID	string	optional	Fallback encrypted MGPTID used when mgptid is not sent.
web	string	required	Website URL, max 300 characters.
url	string	optional	Fallback website URL used when web is not sent, max 300 characters.
kw	string	required	Keyword text, 4 to 80 characters.
brand	string	optional	Brand text, max 60 characters.
location	string	optional	Location text, max 100 characters.
lang	integer	optional	0 US English1 UK English2 Australian English3 Spanish4 Italian5 French6 German7 Portuguese8 Dutch9 Bulgarian10 Czech11 Danish12 Estonian13 Finnish +26 more options 14 Greek15 Hungarian16 Polish17 Norwegian18 Romanian19 Swedish20 Brazilian Portuguese21 Mexican Spanish22 Colombian Spanish23 Argentine Spanish24 Peruvian Spanish25 Canadian English26 Chilean Spanish27 Bolivian Spanish28 Catalan29 Austrian German30 Canadian French31 Belgian Dutch (Flemish)32 Belgian French33 Scottish English34 Slovak35 New Zealand English36 Irish English37 Swiss German38 Croatian39 Turkish
engine	integer	optional	12 OpenAI ChatGPT 4o10 OpenAI GPT 4o Mini19 OpenAI ChatGPT 4.120 OpenAI ChatGPT (Search)28 OpenAI GPT 5 Mini39 OpenAI ChatGPT 5.251 OpenAI GPT 5.532 Perplexity Sonar24 Google Gemini 2.545 Google Gemini 346 Google Gemini 3.1 Pro37 Anthropic Claude Sonnet 4.547 Anthropic Claude Sonnet 4.630 xAI Grok 4 +12 more options 40 xAI Grok 4.152 xAI Grok 4.314 Deepseek 3.253 Deepseek v4 Pro16 Llama 4 Maverick1000 ChatGPT (Latest)1001 DeepSeek (Latest)1002 Perplexity (Latest)1003 Grok (Latest)1004 Anthropic Claude (Latest)1005 Gemini (Latest)1006 Llama (Latest)
samplesize	integer	optional	0 Default Size1 2X MGPT Sampling2 4X MGPT Sampling3 8X MGPT Sampling4 16X MGPT Sampling5 32X MGPT Sampling6 64X MGPT Sampling7 128X MGPT Sampling
brandmatch	integer	optional	0 Most Relevant1 Most Popular2 Best Rating/Reviews3 Most Competitive4 Best Features5 Best Services6 Best Products7 Most Efficient8 Highest Quality9 Highest Satisfaction10 Most Reliable11 Best Quality12 Most Features13 Most Successful +169 more options 14 Budget-Friendly15 Best Value16 Lowest Price17 Premium Quality18 Luxury Picks19 Mid-Range Picks20 Cost-Effective21 High ROI22 Best Deals/Discounts23 Best Subscriptions24 Free Trial Available25 Fastest Delivery26 Same-Day Delivery27 Free Shipping28 In Stock Now29 Nearest/Closest30 Local Favorites31 Newest Releases32 Latest Models33 Trending Now34 Most Recommended35 Expert-Backed36 Award-Winning37 Customer Favorites38 Best Sellers39 Most Reviewed40 Top Rated Support41 Best Customer Service42 Easiest to Use43 Beginner-Friendly44 Advanced/Power Users45 Developer-Friendly46 Enterprise-Ready47 Small-Business Friendly48 Startup-Friendly49 Highly Scalable50 Highly Customizable51 Most Integrations52 Best API53 Privacy-Focused54 Security-Focused55 Compliance-Ready56 Eco-Friendly57 Sustainably Sourced58 Ethical Sourcing59 Transparent Pricing60 Fair Pricing61 Best Warranty62 Best Return Policy63 Flexible Contracts64 Month-to-Month Plans65 No Long-Term Commitment66 Longest Battery Life67 Most Durable68 Weatherproof69 Portable70 Compact71 Lightweight72 Heavy-Duty73 High Performance74 Fastest Speed75 Highest Capacity76 Best Design77 Most Stylish78 Most Color Options79 Accessible/ADA-Friendly80 Family-Friendly81 Kid-Friendly82 Pet-Friendly83 24/7 Support84 After-Hours Support85 Weekend Service86 Walk-In Friendly87 Appointment Only88 On-Site Service89 Remote Service90 Online-Only91 Brick-and-Mortar92 Curbside Pickup93 Local Pickup94 International Shipping95 Nationwide Shipping96 Global Coverage97 Multi-Currency Support98 Installment Plans Available99 Financing Available100 Buy Now, Pay Later101 Accepts Credit Cards102 Accepts PayPal103 Crypto Accepted104 Accepts Insurance105 Medicare Accepted106 Student Discount107 Teacher Discount108 Senior Discount109 Military/Veteran Discount110 Price-Match Guarantee111 30-Day Money-Back112 Lifetime Warranty113 Extended Warranty114 Certified Pre-Owned115 Refurbished Options116 Trade-In Program117 Free Setup118 Free Installation119 Free Migration120 Free Onboarding121 Training Included122 Managed Service123 White-Glove Service124 Self-Service125 DIY-Friendly126 No-Code127 Low-Code128 Open-Source129 Proprietary130 API-First131 Headless Architecture132 Cross-Platform133 Mobile-First134 Offline-Capable135 Cloud-Hosted136 On-Premises137 Hybrid Deployment138 Edge-Optimized139 AI-Powered140 Machine-Learning Based141 No Tracking or Ads142 End-to-End Encrypted143 GDPR-Compliant144 CCPA-Compliant145 SOC 2 Certified146 ISO 27001 Certified147 HIPAA-Compliant148 PCI-DSS Compliant149 FDA-Cleared150 CE-Certified151 UL-Listed152 Energy-Efficient153 Low-Maintenance154 Long Lifespan155 Shockproof156 Waterproof157 Dustproof158 Noise-Cancelling159 Low Noise160 Low Latency161 High Accuracy162 High Precision163 Fast Load Times164 High Uptime165 Guaranteed Response Time166 SLA-Backed167 Verified Sellers168 Authorized Dealer169 Genuine OEM Parts170 Made in USA171 Locally Made172 Handmade173 Artisanal174 Custom-Made175 Made-to-Order176 Limited Edition177 Carbon-Neutral178 Recyclable Packaging179 Cruelty-Free180 Vegan Options181 Fair-Trade182 Women-Owned
k	string	required	API key sent as k in query string, POST body, JSON body; api_key is also accepted, 11 to 120 characters.

02Response

Every response uses the standard envelope (success, application, action, data, meta, error). The data field for this endpoint is documented below.

successaction: rank · HTTP 200

200 response example

{
  "success": true,
  "application": "ranklens",
  "action": "rank",
  "data": [
    {
      "keyword": "white label seo",
      "domain": "string",
      "brand": "SEO Vendor",
      "lowrank": 0,
      "avgrank": 0.0,
      "highrank": 0,
      "confidence": 0.0,
      "appearance": 0,
      "iterations": 0,
      "probability": 0.0,
      "ci_high": 0.0,
      "ci_low": 0.0,
      "ci_width": 0.0,
      "brandmatch": 0,
      "norm_probability": 0.0,
      "norm_ciwidth": 0.0,
      "norm_confidence": 0.0,
      "rankscore": 0.0,
      "mgptid": "string"
    }
  ],
  "meta": {
    "request_id": "req_3f9a7c2e8b41",
    "duration_ms": 1284,
    "upstream_http_code": 200
  },
  "error": null
}

Response schema

successboolean= true

applicationstring= "ranklens"

actionstring= "rank"

dataarrayRanking data, one object per sampling result.

└─keywordstringKeyword that was analyzed.

└─domainstringDomain that was ranked.

└─brandstringBrand name matched in results.

└─lowrankintegerLowest (worst) rank position observed.

└─avgranknumberAverage rank position across iterations.

└─highrankintegerHighest (best) rank position observed.

└─confidencenumberStatistical confidence score 0 to 100.

└─appearanceintegerNumber of times the brand appeared in results.

└─iterationsintegerTotal sampling iterations completed.

└─probabilitynumberRaw probability of appearing in results.

└─ci_highnumberConfidence interval upper bound.

└─ci_lownumberConfidence interval lower bound.

└─ci_widthnumberConfidence interval width.

└─brandmatchintegerBrand match percentage 0 to 100.

└─norm_probabilitynumberNormalized probability score.

└─norm_ciwidthnumberNormalized confidence interval width.

└─norm_confidencenumberNormalized confidence score.

└─rankscorenumberComposite ranking score.

└─mgptidstringEncrypted task ID. Pass to the competitors action to retrieve competitor rankings from this result.

metaobject

└─request_idstring

└─duration_msinteger

└─upstream_http_codeinteger

errornull

successaction: competitors · HTTP 200

200 response example

{
  "success": true,
  "application": "ranklens",
  "action": "competitors",
  "data": [
    {
      "keyword": "white label seo",
      "domain": "string",
      "brand": "SEO Vendor",
      "lowrank": 0,
      "avgrank": 0.0,
      "highrank": 0,
      "confidence": 0.0,
      "appearance": 0,
      "iterations": 0,
      "probability": 0.0,
      "ci_high": 0.0,
      "ci_low": 0.0,
      "ci_width": 0.0,
      "brandmatch": 0,
      "norm_probability": 0.0,
      "norm_ciwidth": 0.0,
      "norm_confidence": 0.0,
      "rankscore": 0.0,
      "mgptid": "string"
    }
  ],
  "meta": {
    "request_id": "req_3f9a7c2e8b41",
    "duration_ms": 1284,
    "upstream_http_code": 200
  },
  "error": null
}

Response schema

successboolean= true

applicationstring= "ranklens"

actionstring= "competitors"

dataarrayCompetitor brands ranked for the same task. Same object structure as rank results.

└─keywordstringKeyword that was analyzed.

└─domainstringDomain that was ranked.

└─brandstringBrand name matched in results.

└─lowrankintegerLowest (worst) rank position observed.

└─avgranknumberAverage rank position across iterations.

└─highrankintegerHighest (best) rank position observed.

└─confidencenumberStatistical confidence score 0 to 100.

└─appearanceintegerNumber of times the brand appeared in results.

└─iterationsintegerTotal sampling iterations completed.

└─probabilitynumberRaw probability of appearing in results.

└─ci_highnumberConfidence interval upper bound.

└─ci_lownumberConfidence interval lower bound.

└─ci_widthnumberConfidence interval width.

└─brandmatchintegerBrand match percentage 0 to 100.

└─norm_probabilitynumberNormalized probability score.

└─norm_ciwidthnumberNormalized confidence interval width.

└─norm_confidencenumberNormalized confidence score.

└─rankscorenumberComposite ranking score.

└─mgptidstringEncrypted task ID. Pass to the competitors action to retrieve competitor rankings from this result.

metaobject

└─request_idstring

└─duration_msinteger

└─upstream_http_codeinteger

errornull

errorHTTP 400, 401, 502, 503, or 504

error response example

{
  "success": false,
  "application": "ranklens",
  "action": "string",
  "data": null,
  "meta": {
    "request_id": "req_3f9a7c2e8b41"
  },
  "error": {
    "code": "invalid_request",
    "message": "The kw field is required.",
    "field": "kw",
    "details": [],
    "apidefinitions": "https://ai.seovendor.co/api/ranklens/definitions"
  }
}

Response schema

successboolean= false

applicationstring= "ranklens"

actionstring

datanull

metaobject

└─request_idstring

errorobject

└─codestringError code returned by the API.

└─messagestringHuman-readable error message.

└─fieldstringInput field associated with the error.

└─detailsarrayAdditional error details.

└─apidefinitionsstringPublic API definitions URL.

POST /api/ranklens/

curl -X POST "https://ai.seovendor.co/api/ranklens/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
  "k": "[API KEY]",
  "action": "rank",
  "mgptid": "mgpt_8f3a21c0e7",
  "web": "https://seovendor.co",
  "kw": "white label seo",
  "brand": "SEO Vendor"
}'
<?php
$ch = curl_init("https://ai.seovendor.co/api/ranklens/");

$payload = [
    "k" => "[API KEY]",
    "action" => "rank",
    "mgptid" => "mgpt_8f3a21c0e7",
    "web" => "https://seovendor.co",
    "kw" => "white label seo",
    "brand" => "SEO Vendor",
];

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Accept: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const response = await fetch("https://ai.seovendor.co/api/ranklens/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    k: "[API KEY]",
    action: "rank",
    mgptid: "mgpt_8f3a21c0e7",
    web: "https://seovendor.co",
    kw: "white label seo",
    brand: "SEO Vendor",
  })
});

const data = await response.json();
console.log(data);
import requests

url = "https://ai.seovendor.co/api/ranklens/"

payload = {
    "k": "[API KEY]",
    "action": "rank",
    "mgptid": "mgpt_8f3a21c0e7",
    "web": "https://seovendor.co",
    "kw": "white label seo",
    "brand": "SEO Vendor",
}

headers = {
    "Content-Type": "application/json",
    "Accept": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

← PreviousSEO Mapping Next →Overview

SEO Vendor API

Overview API Home seovendor.co