Bestseller
Keyword Rank SERP Visibility Competitor Tracking

Keyword Rank Visibility API

Track a domain’s organic search visibility for target keywords

What can this API do?

Keyword and domain visibility check

Submit one keyword and target domain to observe whether the domain appears within the selected rank depth.

Observed SERP item data

Return result items, best rank, top-ranked URL, rank depth, and visibility metrics for reporting workflows.

Competitor comparison fields

Add competitor domains to compare target visibility against other domains in the same observed result set.

Locale and source controls

Use request parameters to align checks with the market, source, and rank depth needed by your SEO workflow.

Credit usage transparency

The response reports request credit cost and remaining credits so scheduled checks can be monitored.

Dashboard and report integration

Use the structured JSON response in SEO dashboards, weekly reports, client reporting, and growth monitoring jobs.

Keyword Rank Visibility API
Annual plan
$999$1999
Subscribe Annually Try Demo Request
Try it for free!
Sign in to get a trial key and test all APIs.
Sign In
Secure checkout powered by Stripe

API Document

HTTP Protocol:HTTPS

HTTP Method:POST

HTTP Endpoint:https://api.gugudata.io/v1/websitetools/search-visibility

Response Type:application/json; charset=utf-8

DEMO Endpoint:https://api.gugudata.io/v1/websitetools/search-visibility/demo

Live Demo:Try Interactive Demo

Full API Docs:developers.gugudata.io

API Request Parameters

NameTypeIs RequiredDefault ValueRemark
appkeystringtrueYOUR_APPKEYObtained after payment
querystringtruesearch visibility apiKeyword or search phrase to observe
domainstringtruegugudata.comTarget domain to match in organic results
sourcestringfalsegoogle_webSearch source. Supported values: google_web, baidu_web. bing_web can be enabled separately.
maxRankintegerfalse20Maximum organic rank depth to observe. Supported values: 10, 20, 50.
localestringfalseenLanguage preference for the observation
regionstringfalseUnited StatesSearch region preference
competitorsarray<string>falseOptional competitor domains to compare, up to 10 domains

API Response Parameters

NameTypeRemark
dataStatusobjectResponse status information
dataobjectSearch visibility observation result
data.querystringObserved keyword
data.domainstringTarget domain
data.sourcestringSearch source used for the observation
data.maxRankintegerObserved rank depth
data.checkedAtstringObservation timestamp
data.creditCostintegerCredits consumed by this request
data.remainingCreditsintegerRemaining credits for the current plan when available
data.metricsobjectVisibility metrics including best rank, top 10, top 20, and score
data.observedItemsarray<object>Observed organic result items
data.brandMatchesarray<object>Organic result matches for the target domain
data.competitorMatchesarray<object>Organic result matches for competitor domains
data.searchMetadataobjectObservation metadata

API Response Status Codes

Status CodeExplanation of Status CodeRemarks
200Request processed successfully.Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`.
400Invalid request parameters or request format.Check required fields, data types, and request body format.
401Missing or unknown application key.Provide a valid `appkey` with the request.
403The application key is recognized but access is not allowed.The key may be expired, inactive, or not permitted for the requested API.
429Request rate or trial usage limit exceeded.Reduce concurrency or retry after the limit window resets.
500Internal service error.Retry later or contact support if the error persists.
503Upstream service unavailable.Retry later; the requested upstream dependency is temporarily unavailable.

Remote MCP

AI client access

Use this API through GuGuData Remote MCP

Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.

Endpoint https://mcp.gugudata.io/mcp
Open MCP Guide
Generic MCP configuration
{
  "mcpServers": {
    "gugudata": {
      "url": "https://mcp.gugudata.io/mcp",
      "transportType": "streamable-http"
    }
  }
}

Code Snippets

Run in Apifox Run in Postman Open LLM Page

Related APIs

Useful APIs to extend this workflow.

View all APIs