Search Data tools
Keyword opportunities, competitor analysis, technical SEO audit, Core Web Vitals, backlink profile and AI visibility.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools40 tools
keyword_opportunities
קריאה3 creditsKeyword ideas grouped by theme with REAL average monthly search volume, competition and top-of-page bid range from Google Ads Keyword Planner (needs a connected Google Ads account). Without it, returns real related searches from the research provider and says there is no volume. Recommends which theme to build a search campaign around.
| Parameter | Type | Description |
|---|---|---|
seed_keywordsOptional | array<string> | — |
topicOptional | string | — |
keywordsOptional | array<string> | Alias of seed_keywords |
urlOptional | string | optional site to seed ideas from |
locationOptional | string | city/region, e.g. İzmir |
countryOptional | string | two-letter country code, default TR |
languageOptional | string | two-letter language code, default the user's language |
limitOptional | integer (10–500) | — |
competitor_ads_and_rankings
קריאה3 creditsCompetitor SERP intelligence: who ranks for which terms (positions), which ads appear, the competitors' Google Ads Transparency Center pages, and gaps you can own. Uses the research provider; up to 5 keywords and 3 competitors per call.
| Parameter | Type | Description |
|---|---|---|
competitorsOptional | array<string> | domains or brand names; default competitors.list from the profile |
keywordsOptional | array<string> | — |
own_domainOptional | string | — |
countryOptional | string | two-letter country code, default TR |
languageOptional | string | two-letter language code, default the user's language |
technical_seo_audit
קריאה3 creditsTechnical SEO audit of a site: status codes, title/meta/H1, canonical, robots.txt, sitemap, hreflang, image alt, response time, viewport, structured data, thin content, duplicate titles, measurement tags found in the source (GA4, Google Ads, GTM, Meta/TikTok/LinkedIn pixels, Microsoft UET/Clarity), plus a Core Web Vitals summary (LCP, INP, CLS from PageSpeed Insights, mobile by default). Returns a prioritised list (worst first) with the named fix for each finding.
| Parameter | Type | Description |
|---|---|---|
urlOptional | string | default digital.site from the profile |
max_pagesOptional | integer (1–10) | — |
core_web_vitalsOptional | boolean | add the Core Web Vitals summary from PageSpeed Insights (default true) |
strategyOptional | mobile | desktop | device for the Core Web Vitals summary (default mobile) |
pagespeed_report
קריאה3 creditsPageSpeed Insights / Core Web Vitals for a URL, mobile and desktop: real-user field data (LCP, INP, CLS, FCP, TTFB at p75 for the page and the whole origin, with good / needs improvement / poor), whether it passes Core Web Vitals, Lighthouse lab scores (performance, accessibility, best practices, SEO) and the biggest opportunities with estimated savings.
| Parameter | Type | Description |
|---|---|---|
urlOptional | string | default digital.site from the profile |
strategiesOptional | array<mobile | desktop> | default both |
backlink_overview
קריאה30 Search Data credits / successful runBacklink profile from the DataForSEO Backlinks API: authority rank, live backlinks, referring domains (incl. nofollow), broken backlinks, spam score, countries/TLDs, the strongest referring domains and an optional competitor comparison. Needs the DataForSEO provider; without it returns an error and charges no credits. Billed in prepaid Search Data credits (30 per successful run, not plan credits); the same query within 30 days returns the cached result for free.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain or URL; default digital.site from the profile |
include_subdomainsOptional | boolean | — |
topOptional | integer (1–50) | top referring domains (default 10) |
compare_withOptional | array<string> | competitor domains for a side-by-side |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
ai_citation_check
קריאה50 Search Data credits / successful runAI visibility check: for each query, does Google show an AI Overview, is your domain among its cited sources, does the brand appear in the answer, which competitors are cited, and your organic position; plus LLM Mentions (answers in AI search that cite your domain; ChatGPT only for US/English). Uses DataForSEO; without it returns an error and charges no credits. Billed in prepaid Search Data credits (50 per successful run, not plan credits); the same query within 30 days returns the cached result for free.
| Parameter | Type | Description |
|---|---|---|
domainOptional | string | default digital.site from the profile |
brandOptional | string | default the brand name |
queriesOptional | array<string> | searches/questions to check; default from sector, location and products |
countryOptional | string | two-letter country code, default TR |
languageOptional | string | two-letter language code, default the user's language |
include_llm_mentionsOptional | boolean | also query LLM Mentions (default true) |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
keyword_gap_vs_search_console
קריאה3 creditsCross-check high-volume keywords (Google Ads Keyword Planner) against your Search Console queries: where you already rank but are under-invested (positions 4–20), where you do not appear at all, where you win, plus striking-distance queries. Needs Search Console; volume needs Google Ads.
| Parameter | Type | Description |
|---|---|---|
keywordsOptional | array<string> | — |
site_urlOptional | string | — |
daysOptional | integer (7–90) | — |
seed_keywordsOptional | array<string> | Alias of keywords |
topicOptional | string | single seed used when keywords is empty |
locationOptional | string | — |
languageOptional | string | two-letter language code, default the user's language |
limitOptional | integer | — |
geo_content_opportunities
קריאה3 creditsGEO research: the questions people ask (people-also-ask, related searches), who ranks now, and for each question the content format, outline and schema most likely to be cited by AI answer engines. Uses the research provider and the AI layer (falls back to rule-based suggestions).
| Parameter | Type | Description |
|---|---|---|
topicOptional | string | product category or topic; default business.sector |
extra_queriesOptional | array<string> | — |
countryOptional | string | two-letter country code, default TR |
languageOptional | string | two-letter language code, default the user's language |
seo_keyword_research
קריאה40 Search Data credits / successful runKeyword ideas from one seed: monthly Google volume, CPC, competition, keyword difficulty and search intent. Billed in prepaid Search Data credits (40 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
seedRequired | string | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
limitOptional | integer (1–500) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_keyword_trends
קריאה40 Search Data credits / successful runMonthly search history per keyword (up to 20): series, peak and low month, seasonality ratio and the last-3-month trend. Billed in prepaid Search Data credits (40 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
keywordsRequired | array<string> | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_ranked_keywords
קריאה50 Search Data credits / successful runEvery keyword a domain ranks for organically, by volume: position, URL, CPC and estimated traffic. Billed in prepaid Search Data credits (50 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_paid_keywords
קריאה70 Search Data credits / successful runKeywords where a domain shows Google search ads, with ad position, landing URL and ad text, by volume. Billed in prepaid Search Data credits (70 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_competitor_gap
קריאה50 Search Data credits / successful runKeyword gap: what the competitor ranks for and you do not rank for at all, highest volume first, with the competitor's position and URL. Billed in prepaid Search Data credits (50 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
your_domainOptional | string | domain; default digital.site from the profile |
competitor_domainRequired | string | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_serp_analysis
קריאה30 Search Data credits / successful runLive Google results page for a keyword: organic ranking, SERP features, people-also-ask, related searches, local pack and AI Overview sources. Billed in prepaid Search Data credits (30 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
keywordRequired | string | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
depthOptional | integer (10–100) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_site_technologies
קריאה40 Search Data credits / successful runTechnology stack of a website (CMS, analytics, ads, payments, frameworks) plus public e-mails, phones and social profiles. Billed in prepaid Search Data credits (40 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_technical_audit
קריאה40 Search Data credits / successful runProvider-side technical audit of one page: on-page score, failed checks, headings, word count, links, load timing and resource errors. Billed in prepaid Search Data credits (40 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
urlOptional | string | page URL; default digital.site |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_site_crawl
קריאה80 Search Data credits / successful runSite-wide technical crawl (up to 500 pages): progress, on-page score, broken links/resources, duplicates, non-indexable pages and issue counts; with issue=<code> the affected pages. Billed in prepaid Search Data credits (80 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Asynchronous: the first call opens a task and returns task_id; reading the task with task_id is free. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
domainOptional | string | domain; default digital.site from the profile |
max_pagesOptional | integer (1–500) | — |
task_idOptional | string | id returned by the first call; reading it is free |
issueOptional | string | issue code from issue_counts to list the affected pages |
limitOptional | integer (1–1000) | — |
offsetOptional | integer (0–…) | — |
seo_content_brief
קריאה120 Search Data credits / successful runContent brief for a keyword: top 10 results, length and subheadings of the top 3 pages, questions to answer, related terms and a target length. Billed in prepaid Search Data credits (120 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
keywordRequired | string | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_brand_monitor
קריאה50 Search Data credits / successful runBrand mentions across the web: total, one page per domain with snippet and date, and the positive/negative/neutral split. Billed in prepaid Search Data credits (50 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
brandRequired | string | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_reviews
קריאה40 Search Data credits / successful runGoogle reviews of a business: rating, review count, rating split and unanswered reviews in the latest 50, with texts and owner answers. Billed in prepaid Search Data credits (40 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Asynchronous: the first call opens a task and returns task_id; reading the task with task_id is free. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | business name with city, a Google CID or a place_id |
sourceOptional | — | |
task_idOptional | string | id returned by the first call; reading it is free |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
seo_anchors
קריאה60 Search Data credits / successful runAnchor texts pointing to a domain: links and referring domains per anchor, authority and spam score; filter by spam score. Billed in prepaid Search Data credits (60 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
limitOptional | integer (1–1000) | — |
status_typeOptional | live | lost | all | — |
order_byOptional | backlinks | referring_domains | rank | first_seen | — |
min_spam_scoreOptional | integer (0–100) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_backlink_list
קריאה60 Search Data credits / successful runIndividual backlinks, one row each: source page, target, anchor, dofollow, authority, spam score, first/last seen, lost/broken. Billed in prepaid Search Data credits (60 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
limitOptional | integer (1–1000) | — |
status_typeOptional | live | lost | all | — |
dofollowOptional | boolean | — |
from_domainOptional | string | — |
order_byOptional | rank | domain_from_rank | first_seen | last_seen | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_best_pages_by_links
קריאה60 Search Data credits / successful runThe pages of a domain that earn the most backlinks and referring domains. Billed in prepaid Search Data credits (60 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_broken_backlinks
קריאה60 Search Data credits / successful runBacklinks that land on broken (4xx/5xx) pages of a domain, grouped by broken target URL, so they can be won back with 301 redirects. Billed in prepaid Search Data credits (60 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_bulk_spam_score
קריאה40 Search Data credits / successful runSpam score (0–100) for up to 100 domains in one call, riskiest first. Billed in prepaid Search Data credits (40 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
domainsRequired | array<string> | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_referring_networks
קריאה60 Search Data credits / successful runIP addresses or subnets the backlinks come from; many links from one network is a link-network signal. Billed in prepaid Search Data credits (60 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
network_typeOptional | ip | subnet | — |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_link_intersect
קריאה80 Search Data credits / successful runLink intersect: domains linking to your competitors but not to you, with how many competitors each links to. Billed in prepaid Search Data credits (80 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
competitorsRequired | array<string> | — |
exclude_targetOptional | string | domain to exclude; default your digital.site |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_local_listings
קריאה60 Search Data credits / successful runIs the business listed on local directories and social profiles? One indexed-page search per directory (up to 8), with found URLs and the missing ones. Billed in prepaid Search Data credits (60 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
brandRequired | string | — |
cityOptional | string | — |
directoriesOptional | array<string> | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_full_analysis
קריאה200 Search Data credits / successful runSEO + AEO + GEO in one call: backlink summary, top ranked keywords, competitor gap, homepage technical audit and AI Overview citation for the top keywords, with prioritised next steps. Billed in prepaid Search Data credits (200 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
domainOptional | string | domain; default digital.site from the profile |
competitorOptional | string | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
homepage_urlOptional | string | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_rank_tracker
קריאה30 Search Data credits / successful runMeasure the current Google position of a domain for up to 10 keywords; each measurement is stored for 30 days and read by seo_rank_history. Billed in prepaid Search Data credits (30 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | domain; default digital.site from the profile |
keywordsRequired | array<string> | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
deviceOptional | desktop | mobile | — |
depthOptional | integer (10–100) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_rank_history
קריאה0 creditsStored rank measurements from seo_rank_tracker as a series per keyword (latest, best, change). Free, no external call.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | — |
daysOptional | integer (1–30) | — |
limitOptional | integer (1–200) | — |
seo_history
קריאה0 creditsThe paid search-data queries this account already ran, newest first: tool, query, credits, cache use, task_id and whether the stored result can still be reused for free; plus the credit balance. Free.
| Parameter | Type | Description |
|---|---|---|
limitOptional | integer (1–100) | — |
seo_content_lint
קריאה0 creditsLocal check for template/AI footprints in copy: cliché phrases, long and uniform sentences, repeated openers, dash and exclamation density, with a 0–100 score. Free, no external call.
| Parameter | Type | Description |
|---|---|---|
textRequired | string | — |
languageOptional | string | — |
seo_geo_tracker
קריאה300 Search Data credits / successful runAI answer visibility: asks ChatGPT (web search) and Perplexity your questions, then reports whether the brand is named, whether your domain is cited, which competitors appear, and the rates across repeats. Billed in prepaid Search Data credits (300 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
brandRequired | string | — |
promptsRequired | array<string> | — |
competitorsOptional | array<string> | — |
brand_domainOptional | string | default digital.site |
enginesOptional | array<chat_gpt | perplexity> | — |
repeatsOptional | integer (1–3) | — |
locationOptional | string | two-letter country for web search |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
seo_llm_mentions
קריאה50 Search Data credits / successful runMentions of a brand name (in the answer) and a domain (as a source) in the provider's tracked AI answers: totals, questions with AI search volume, and other brands named alongside. google = AI Overview; chat_gpt is US/English only. Billed in prepaid Search Data credits (50 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
brandOptional | string | — |
domainOptional | string | — |
platformOptional | google | chat_gpt | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
limitOptional | integer (1–100) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
aso_app_search
קריאה30 Search Data credits / successful runApp store search ranking: which apps rank for a keyword on Google Play or the App Store, with rating, reviews, developer and price. Billed in prepaid Search Data credits (30 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Asynchronous: the first call opens a task and returns task_id; reading the task with task_id is free. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
storeOptional | google_play | app_store | default google_play |
keywordOptional | string | — |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
depthOptional | integer (10–200) | — |
task_idOptional | string | id returned by the first call; reading it is free |
aso_app_info
קריאה20 Search Data credits / successful runApp listing details: title and description (with lengths), rating, review count, version, installs, category and update dates. Billed in prepaid Search Data credits (20 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Asynchronous: the first call opens a task and returns task_id; reading the task with task_id is free. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
storeOptional | google_play | app_store | default google_play |
app_idOptional | string | Google Play package name (com.example.app) or numeric App Store id |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
task_idOptional | string | id returned by the first call; reading it is free |
aso_app_reviews
קריאה40 Search Data credits / successful runApp reviews: rating split, latest reviews with version, and how many have no developer reply. Billed in prepaid Search Data credits (40 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Asynchronous: the first call opens a task and returns task_id; reading the task with task_id is free. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
storeOptional | google_play | app_store | default google_play |
app_idOptional | string | Google Play package name (com.example.app) or numeric App Store id |
locationOptional | string | two-letter country code (default TR), a numeric location code or a location name |
languageOptional | string | two-letter language code; default tr for TR, else en |
depthOptional | integer (10–1500) | — |
sort_byOptional | newest | most_relevant | Google Play only |
task_idOptional | string | id returned by the first call; reading it is free |
aso_app_competitors
קריאה50 Search Data credits / successful runApps competing for the same store keywords: shared keyword count, average position and position buckets (US store, English). Billed in prepaid Search Data credits (50 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
storeOptional | google_play | app_store | default google_play |
app_idRequired | string | Google Play package name (com.example.app) or numeric App Store id |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
aso_keywords_for_app
קריאה50 Search Data credits / successful runStore keywords an app ranks for, with in-store volume and position — store keyword ideas, also for a competitor's app (US store, English). Billed in prepaid Search Data credits (50 per successful run, not plan credits); the same query within 30 days returns the cached result for free, refresh=true forces a new billed run. Needs the DataForSEO provider; without it returns an error and charges nothing.
| Parameter | Type | Description |
|---|---|---|
storeOptional | google_play | app_store | default google_play |
app_idRequired | string | Google Play package name (com.example.app) or numeric App Store id |
limitOptional | integer (1–1000) | — |
refreshOptional | boolean | true runs a new, billed query instead of the free 30-day cached result |
Write tools2 tools
draft_search_campaign_from_audit
כתיבה2 creditsDraft a Google search campaign from the audit and keyword gaps: daily budget, themed ad groups with match types, negative list, responsive search ad copy. Saved as a paused DRAFT only; nothing goes live. Returns the preview and the next steps (update_campaign op=publish, then add_negative_keywords).
| Parameter | Type | Description |
|---|---|---|
daily_budgetRequired | number | in the ad account currency |
nameOptional | string | — |
ad_groupsOptional | array<object> | — |
keywordsOptional | array<string> | — |
negative_keywordsOptional | array<string> | — |
audit_findingsOptional | array<string> | finding codes from technical_seo_audit |
landing_urlOptional | string | — |
goalOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
seo_rank_untrack
כתיבהIrreversible0 creditsStop tracking keywords (or a whole domain) measured with seo_rank_tracker: deletes their stored measurements so seo_rank_history no longer shows them. There is no automatic scheduled measurement, so nothing else runs afterwards. Returns not_tracked with the tracked keywords if nothing matches. Without keywords it needs confirm=true. Spent credits are not refunded. Free, no external call.
| Parameter | Type | Description |
|---|---|---|
targetOptional | string | tracked domain; default digital.site from the profile |
keywordsOptional | array<string> | keywords to stop tracking; omit to stop tracking every keyword of the domain |
confirmOptional | boolean | required (true) when keywords is omitted: the whole domain's measurements are deleted |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.