SE Ranking Data API integration
SE Ranking Data API returns SEO data on any website without setting up a project: backlink profiles (counts, backlink and referring domain lists, new and lost links, anchors, IPs, page and domain authority with history, full exports), organic and paid keyword rankings, pages, subdomains, competitors and keyword gaps of a domain, keyword metrics and ideas, AI search visibility (ChatGPT, Gemini, Perplexity, Google AI Overviews and AI Mode), Google results-page snapshots and website audits. Most calls spend credits of the SE Ranking API subscription (each tool states its cost; get_api_subscription shows the balance), so set limits deliberately; domain, keyword and AI data are refreshed monthly. What a key may call depends on the SE Ranking API plan. Rate limit: 10 requests per second per key (1 during a trial). Not included: the Project API (rank-tracking projects, sub-accounts, marketing plan), SE Visible, the Local Marketing API, the POST batch twins of the backlink reads (the GET tools already take up to 100 targets) and prompt generation. Authentication: an API key from the API Dashboard, sent as Authorization: Token <key>.
Say what should happen.
The workflow builds itself.
What you can do with SE Ranking Data API
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Website audit, 7 operations
create_advanced_auditCreate advanced auditPOSTAgents: ask firstStarts an audit that renders JavaScript on each page (single-page apps) and returns its id; poll get_audit_status. Costs 20 credits per page crawled (max_pages is required). Can e-mail a report when done.create_standard_auditCreate standard auditPOSTAgents: ask firstStarts an HTML crawl audit of a website and returns its id; poll get_audit_status. Costs 2 credits per page crawled (max_pages is required). Can e-mail a report when done (send_report).delete_auditDelete auditDELETEAgents: ask firstPermanently deletes a website audit report and all its data. This cannot be undone. Free.list_auditsList auditsGETAgents: ask firstWebsite audits of the account with status, latest and previous health score and issue counts; filter by title or URL and by date. Free.recheck_advanced_auditRecheck advanced auditPOSTAgents: ask firstRuns an existing audit again with JavaScript rendering and its original settings, send_report included: a new billed crawl, 20 credits per page crawled.recheck_standard_auditRecheck standard auditPOSTAgents: ask firstRuns an existing audit again as a standard HTML crawl with its original settings, send_report included: a new billed crawl, 2 credits per page crawled.update_audit_titleUpdate audit titlePATCHAgents: ask firstRenames a website audit report (changes its title). Free.
Ai search visibility, 4 operations
get_ai_search_overviewGet ai search overviewGETAgents: ask firstAI search visibility of a domain or URL in one AI engine and country: brand and link presence, AI traffic opportunity and average position, with change and monthly trends. Costs 800 credits.get_ai_search_overview_all_enginesGet ai search overview all enginesGETAgents: ask firstLike get_ai_search_overview but aggregated across all AI engines (not a sum of the per-engine values), with monthly trends. Costs 1,800 credits per call.get_ai_search_overview_all_engines_currentGet ai search overview all engines currentGETAgents: ask firstLike get_ai_search_overview_all_engines (all AI engines aggregated) but only the current summary and its change, without monthly trends. Costs 1,800 credits per call.get_ai_search_overview_currentGet ai search overview currentGETAgents: ask firstLike get_ai_search_overview (one AI engine and country) but only the current summary and its change, without the monthly trends. The credit cost is not stated by SE Ranking.
Keyword idea, 4 operations
list_longtail_keywordsList longtail keywordsGETAgents: ask firstLong-tail variations of a seed keyword in one country, as plain keyword strings with a total count. Costs 1 credit per keyword returned (limit, default 100).list_question_keywordsList question keywordsGETAgents: ask firstQuestion-form keywords (who, what, how, why...) around a seed keyword in one country, with volume, CPC, competition and difficulty. limit is required: each keyword returned costs 10 credits.list_related_keywordsList related keywordsGETAgents: ask firstKeywords topically related to a seed keyword (overlapping search results) in one country, with a relevance score, volume, CPC and difficulty. limit is required: each keyword returned costs 10 credits.list_similar_keywordsList similar keywordsGETAgents: ask firstKeywords with the same intent as a seed keyword (synonyms, close variants) in one country, with volume, CPC, competition, difficulty and intents. limit is required: each keyword returned costs 10 credits.
Backlink, 3 operations
count_backlinksCount backlinksGETAgents: ask firstTotal number of live backlinks of up to 100 domains, hosts or URLs. Costs 2 credits per target.list_all_backlinks_pagedList all backlinks pagedGETAgents: ask firstEvery backlink of a target, page by page with a cursor (no filters): pass the returned next as next until it is absent. Costs 1 credit per backlink returned; limit is required (up to 100,000 per page).list_backlinksList backlinksGETAgents: ask firstBacklinks pointing to one domain, host or URL, with filters on authority, URLs, anchor text and nofollow, and sorting. Costs 1 credit per backlink returned (limit, default 100).
Ai prompt, 2 operations
list_prompts_by_brandList prompts by brandGETAgents: ask firstPrompts whose AI answer (in one engine and country) mentions a brand name, linked or not, with the full answer text and its links. limit is required: each prompt returned costs 200 credits.list_prompts_by_targetList prompts by targetGETAgents: ask firstPrompts whose AI answer (in one engine and country) links to or mentions a domain or URL, with the full answer text and its links. limit is required: each prompt returned costs 200 credits.
Backlink change, 2 operations
count_new_lost_backlinksCount new lost backlinksGETAgents: ask firstDaily counts of new and lost backlinks of one target over a date range, with the same filters as list_new_lost_backlinks. Costs 10 credits plus 1 credit per day returned.list_new_lost_backlinksList new lost backlinksGETAgents: ask firstBacklinks of one target that were found or lost in a date range (default: yesterday to today), with the reason a link was lost. Costs 1 credit per backlink returned (limit, default 100).
Backlink export, 2 operations
get_backlinks_export_statusGet backlinks export statusGETAgents: ask firstStatus of a backlinks export started with start_backlinks_export: queued_for_processing, processing, complete (download_file then holds the .csv.gz link), rejected or unknown. Free.start_backlinks_exportStart backlinks exportGETAgents: ask firstStarts a background export of every backlink of a target to a .csv.gz file and returns its task_id; poll get_backlinks_export_status until task_status is complete. Costs 1 credit per backlink exported (count_backlinks gives the total).
Domain overview, 2 operations
get_domain_overviewGet domain overviewGETAgents: ask firstOrganic and paid keyword statistics of a domain (or one URL) in one country's database: keyword counts, traffic and its value, position changes and position spread. Costs 100 credits.get_domain_worldwide_overviewGet domain worldwide overviewGETAgents: ask firstWorldwide organic and paid totals of a domain for the current month (keywords, traffic, traffic value), optionally with position changes and a per-country breakdown. Costs 100 credits.
Paid ad, 2 operations
list_domain_paid_adsList domain paid adsGETAgents: ask firstKeywords one domain bid on in paid search in one country, with its ad copy and landing pages by month and each keyword's volume, CPC and competition. For the advertisers on one keyword use list_keyword_paid_ads. Costs 100 credits.list_keyword_paid_adsList keyword paid adsGETAgents: ask firstDomains that ran paid search ads on one keyword in one country, with their ad copy and landing pages by month. For the keywords one domain bids on use list_domain_paid_ads. Costs 100 credits.
Referring domain, 2 operations
count_referring_domainsCount referring domainsGETAgents: ask firstNumber of unique referring domains of up to 100 domains, hosts or URLs. Costs 2 credits per target.list_referring_domainsList referring domainsGETAgents: ask firstDomains linking to one target, with their backlink count and authority. Costs 1 credit per domain returned (limit, default 100).
Referring domain change, 2 operations
count_new_lost_referring_domainsCount new lost referring domainsGETAgents: ask firstDaily counts of new and lost referring domains of one target over a date range. Costs 10 credits plus 1 credit per day returned.list_new_lost_referring_domainsList new lost referring domainsGETAgents: ask firstReferring domains of one target that gained a first backlink or lost one in a date range (default: yesterday to today). Costs 1 credit per domain returned (limit, default 100).
Referring ip, 2 operations
count_referring_ipsCount referring ipsGETAgents: ask firstNumber of unique referring IPv4 addresses of up to 100 domains, hosts or URLs. Costs 2 credits per target.list_referring_ipsList referring ipsGETAgents: ask firstIPv4 addresses hosting pages that link to one target, with backlink and referring domain counts per IP. Costs 1 credit per IP returned (limit, default 100).
Serp result, 2 operations
get_serp_task_advanced_resultsGet serp task advanced resultsGETAgents: ask firstFull results of a completed SERP task, every item type (organic, ads, featured snippet, AI Overview, People also ask, related searches, images...). Costs 10 credits (0 for mobile tasks).get_serp_task_resultsGet serp task resultsGETAgents: ask firstStandard results of a SERP task (organic, ads and featured snippet items) once collected, else status processing; results are kept 24 hours. Free. get_serp_task_advanced_results adds every item type.
Serp task, 2 operations
create_serp_tasksCreate serp tasksPOSTAgents: ask firstQueues one Google results-page collection per keyword and returns a task id each; read results with get_serp_task_results. Costs 10 credits per keyword. Give location_id or google_ads_location_id.list_serp_tasksList serp tasksGETAgents: ask firstSERP tasks submitted in the last 24 hours, with task id, keyword, location, language, whether it is completed and when it was added. Free.
Ai search leaderboard, 1 operation
get_ai_search_leaderboardGet ai search leaderboardPOSTAgents: ask firstShare of voice in AI answers of one domain against 1 to 10 competitors across chosen AI engines in one country, ranked, with brand and link presence per engine. Costs a flat 7,500 credits per call.
Anchor, 1 operation
list_backlink_anchorsList backlink anchorsGETAgents: ask firstAnchor texts used in backlinks to one target, with backlink and referring domain counts per anchor. Costs 1 credit per anchor returned (limit, default 100).
Audit issue, 1 operation
list_audit_url_issuesList audit url issuesGETAgents: ask firstEvery issue (error, warning, notice) an audit found on one page, with its evidence, plus the page's full data. Give url_id (from list_audit_pages) or url. Free.
Audit issue page, 1 operation
list_audit_issue_pagesList audit issue pagesGETAgents: ask firstURLs affected by one issue code (from get_audit_report sections) in an audit, for example title_duplicate or http4xx; paged. Free.
Audit link, 1 operation
list_audit_linksList audit linksGETAgents: ask firstEvery link an audit found across the site (hyperlinks, canonicals...), with status, source page, anchor and nofollow; filter by internal or external and by up to two conditions. Free.
Audit page, 1 operation
list_audit_pagesList audit pagesGETAgents: ask firstEvery page an audit crawled, with HTTP status, depth, load time, title, description, H1, word count, link and issue counts and indexability; paged. Free.
Audit report, 1 operation
get_audit_reportGet audit reportGETAgents: ask firstReport of a finished website audit: health score, page and issue totals, domain data and every check grouped by section with its status and number of affected pages. Free.
Audit run, 1 operation
get_audit_historyGet audit historyGETAgents: ask firstOne past run of an audit, by date: the crawl settings used, domain data then, pages affected per issue code and totals. Free.
Audit status, 1 operation
get_audit_statusGet audit statusGETAgents: ask firstProgress of a website audit: queued, processing, finished, cancelled or expired, with pages crawled and issue counts so far. Poll until finished, then call get_audit_report. Free.
Authority, 1 operation
get_authorityGet authorityGETAgents: ask firstPage authority (InLink Rank) and domain authority (Domain InLink Rank), 0 to 100, of up to 100 URLs or domains, computed in real time. Costs 10 credits per target.
Authority distribution, 1 operation
get_domain_authority_distributionGet domain authority distributionGETAgents: ask firstHow many referring domains of one target sit at each domain authority score (0 to 100). Costs 1 credit per referring domain counted.
Backlink history, 1 operation
get_backlinks_historyGet backlinks historyGETAgents: ask firstNumber of live backlinks of one target on each day of a date range (default: yesterday to today), to chart growth or decline. Costs 10 credits plus 1 credit per day returned.
Backlink metric, 1 operation
get_backlinks_metricsGet backlinks metricsGETAgents: ask firstKey backlink counts of up to 100 domains, hosts or URLs: backlinks, referring domains, IPs, subnets, dofollow and nofollow, .edu and .gov links. Cheaper than get_backlinks_summary. Costs 10 credits per target.
Backlink summary, 1 operation
get_backlinks_summaryGet backlinks summaryGETAgents: ask firstBacklink profile summary of up to 100 domains, hosts or URLs: backlink, referring domain, IP and subnet counts, authority, top anchors, top pages, TLDs and countries. Costs 100 credits per target.
Brand, 1 operation
discover_brandDiscover brandGETAgents: ask firstBrand name(s) SE Ranking associates with a domain or URL, to pass as brand to the AI search tools. Costs 100 credits.
Competitor, 1 operation
list_domain_competitorsList domain competitorsGETAgents: ask firstUp to 500 organic or paid competitors of a domain in one country, ranked by shared keywords, with relevance, their keyword total, keywords the domain misses, traffic and value. No paging or sorting. Costs 100 credits.
Domain authority, 1 operation
get_domain_authorityGet domain authorityGETAgents: ask firstDomain authority (Domain InLink Rank, 0 to 100) of the root domain of up to 100 domains, hosts or URLs. Costs 5 credits per target.
Domain authority history, 1 operation
get_domain_authority_historyGet domain authority historyGETAgents: ask firstDomain authority (Domain InLink Rank) of a root domain over time, by day, week or month (default: the last month). Costs 4 credits plus 1 credit per date point returned.
Domain history, 1 operation
get_domain_historyGet domain historyGETAgents: ask firstMonth-by-month history of a domain's (or one URL's) keyword count, traffic, traffic value and position spread in one country's database, organic or paid. Costs 100 credits.
Domain keyword, 1 operation
list_domain_keywordsList domain keywordsGETAgents: ask firstKeywords a domain or one URL ranks for (organic) or advertises on (adv) in one country, with position, volume, traffic and SERP features; filters, sorting, pages and past monthly snapshots. Costs 100 credits.
Domain page, 1 operation
list_domain_pagesList domain pagesGETAgents: ask firstPages of a domain that rank in one country's database, with keyword count, traffic, traffic share and value per page, organic or paid; filters, sorting and paging. Costs 100 credits.
Keyword comparison, 1 operation
compare_domain_keywordsCompare domain keywordsGETAgents: ask firstKeywords two domains or URLs share (diff=0) or the keyword gap (diff=1: the first ranks, compare does not), in one country, with both positions, URLs and traffic. Costs 100 credits.
Keyword metric, 1 operation
get_keyword_metricsGet keyword metricsPOSTAgents: ask firstSearch volume, CPC, competition, difficulty, intents and 12 months of volume history for 1 to 5,000 keywords in one country's database. Costs 100 credits per call per its reference page; SE Ranking's cost table says 10 per keyword.
Linked page, 1 operation
list_pages_with_backlinksList pages with backlinksGETAgents: ask firstPages of one target that have at least one live backlink, with backlink and referring domain counts per page. Costs 1 credit per page returned (limit, default 100).
Page authority, 1 operation
get_page_authorityGet page authorityGETAgents: ask firstPage authority (InLink Rank, 0 to 100) of up to 100 URLs. Costs 5 credits per target.
Page authority history, 1 operation
get_page_authority_historyGet page authority historyGETAgents: ask firstPage authority (InLink Rank) of one full page URL over time, by day, week or month (default: the last month). Costs 4 credits plus 1 credit per date point returned.
Referring subnet, 1 operation
count_referring_subnetsCount referring subnetsGETAgents: ask firstNumber of unique referring subnets (C-blocks) of up to 100 domains, hosts or URLs. Costs 2 credits per target.
Serp html, 1 operation
download_serp_htmlDownload serp htmlGETAgents: ask firstRaw HTML of a completed SERP task as a ZIP file (manifest.json plus one HTML file per results page: 1 for mobile, 10 for desktop). Free.
Serp location, 1 operation
list_serp_locationsList serp locationsGETAgents: ask firstLocations usable for create_serp_tasks, with their location_id (and Google Ads id on request), filtered by country or city name. Free.
Subdomain, 1 operation
list_domain_subdomainsList domain subdomainsGETAgents: ask firstSubdomains of a domain that rank in one country's database, with keyword count, traffic, traffic share and value each, organic or paid; filters, sorting and paging. Costs 100 credits.
Subscription, 1 operation
get_api_subscriptionGet api subscriptionGETAgents: ask firstData API subscription of the key: status (active, inactive, expired or disabled), start and expiry dates, credit limit and credits left. Free.
Url overview, 1 operation
get_url_worldwide_overviewGet url worldwide overviewGETAgents: ask firstWorldwide organic and paid totals of one URL for the current month: keyword count, traffic and traffic value. Costs 100 credits.
Use SE Ranking Data API from Claude Code, Cursor or Codex
Connect SE Ranking Data API in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its SE Ranking Data API operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect SE Ranking Data API
- Create your workspace
Sign up free. Nothing to install.
- Connect SE Ranking Data API once
Add your SE Ranking Data API connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
SE Ranking Data API integration FAQ
What can you do with the SE Ranking Data API integration?
LiveContext exposes 70 operations on SE Ranking Data API, covering website audit, ai search visibility, keyword idea and backlink.
