DataFluxor

Audits brand citations and mentions in Google AI Overviews (SGE) for search queries. From the same page it also reports the brand's organic top-10 position, a visibility_signal, cited domains, People Also Ask and related searches; batches add cited-domain share of voice. sentiment_context is only a rough keyword-based tone indicator, not a reliable sentiment judgement. Credits: 5 per prompt fetched live, 1 when served from cache; undetermined observations are free. When the daily live-page allowance or the balance does not cover live Google pages, cached prompts are still served at 1 credit and the rest are not checked (error_code DAILY_LIVE_LIMIT or INSUFFICIENT_CREDITS). The result is returned once and is not retained as a project run; use scraper_run_create for retained background work. If the call would outlast the connection (many items, deep or fresh SERPs) or the platform has no free capacity, it is not failed: the result is an accepted answer (accepted true, run_id, state, next_step) and the work runs as a saved run; poll scraper_run_get with run_id. Nothing is charged until it completes, and the same idempotency_key never charges twice.

ai_overview_visibility_tracker

Explicitly request server cancellation. Work already in flight can still finish; the original confirmed charge is never silently refunded or replayed. Poll scraper_run_get until terminal.

scraper_run_cancel

Compares the target and competitor domains across a caller-supplied keyword list; it does not discover a competitor's full keyword set. Every keyword row carries its sample: serp_results_returned, strict serp_complete, observed_at and cache_age_seconds. A category that claims an absence (missing, neither, target_only) is marked provisional when the sample holds fewer results than the requested depth (a top-10 page often shows only 8 or 9), so absence is not proven. opportunity_score is a documented heuristic; score_inputs and score_method show how it was computed. Credits: per Google results page actually fetched (5 live, 1 cached) for audited keywords; depth defaults to 30 results (3 pages per keyword) and deeper samples cost more. When the daily live-page allowance or the balance does not cover live pages, cached keywords are still served at 1 credit per page and the rest are not sampled (error_code DAILY_LIVE_LIMIT or INSUFFICIENT_CREDITS). The result is returned once and is not retained as a project run; use scraper_run_create for retained background work. If the call would outlast the connection (many items, deep or fresh SERPs) or the platform has no free capacity, it is not failed: the result is an accepted answer (accepted true, run_id, state, next_step) and the work runs as a saved run; poll scraper_run_get with run_id. Nothing is charged until it completes, and the same idempotency_key never charges twice.

competitor_gap_extractor

Retrieve retained run status, item evidence, final or incomplete result and confirmed/unknown original credit cost. This never executes or charges again. Batch runs settle each item as it completes: an item's result appears only once its credits are settled (see settlement, credits and result_available per item), so a poll never returns unsettled paid work. When a run ends before finishing, outcome (completed, partial, timed_out_partial, failed), settled_credits and settled_items describe what was delivered and charged, unfinished_items lists the rest by index and label, and resume.inputs is the input for a new run over only those items (settled items are not re-acquired or re-charged).

scraper_run_get

Harvests autocomplete suggestions from Google using alphabet & question matrix expansion. Returns suggestions that contain all of the seed's words; completions of another version of the seed (for example a different number) are listed separately in related_suggestions. Check coverage (full, sparse or none) and note: new or rare topics often have sparse autocomplete data, and an empty list is not an error. Credits: 1 per call. The result is returned once and is not retained as a project run; use scraper_run_create for retained background work. If the call would outlast the connection (many items, deep or fresh SERPs) or the platform has no free capacity, it is not failed: the result is an accepted answer (accepted true, run_id, state, next_step) and the work runs as a saved run; poll scraper_run_get with run_id. Nothing is charged until it completes, and the same idempotency_key never charges twice.

google_suggest_harvest

Checks whether each URL appears in a Google site: search: a heuristic, not Search Console. Fixed settings: US, English, desktop, first 10 results (the result states method, location, language, confidence and a disclaimer). Each URL gets verdict observed, not_observed (not seen in that search; not proof it is not indexed) or unknown (is_indexed null, with a reason such as result_urls_hidden or google_challenge); checked_at is when the check ran and observed_at when Google's page was fetched (earlier when cached). Credits: 5 per URL checked live, 1 when served from cache; unknown checks are free. There is no market option: searches always run as US, English, desktop. When the daily live-page allowance or the balance does not cover live pages, cached URLs are still served at 1 credit and the rest are not checked (error_code DAILY_LIVE_LIMIT or INSUFFICIENT_CREDITS). The result is returned once and is not retained as a project run; use scraper_run_create for retained background work. If the call would outlast the connection (many items, deep or fresh SERPs) or the platform has no free capacity, it is not failed: the result is an accepted answer (accepted true, run_id, state, next_step) and the work runs as a saved run; poll scraper_run_get with run_id. Nothing is charged until it completes, and the same idempotency_key never charges twice.

google_index_check

Google organic results for 247 countries, each with a default language (most also accept others). Credits: 5 per Google results page fetched live, 1 per page served from cache; live pages also count toward the plan's daily live-page allowance (DAILY_LIVE_LIMIT when used; cached results are still served). A fresh result can take 30-120 seconds. If a call times out, repeat the identical call: the search keeps running server-side and the repeat returns the finished result from cache at 1 credit per page, without a second acquisition. For long or batch work, start it with scraper_run_create (tool "serp") and collect it with scraper_run_get. The result is returned once and is not retained as a project run; use scraper_run_create for retained background work. If the call would outlast the connection (many items, deep or fresh SERPs) or the platform has no free capacity, it is not failed: the result is an accepted answer (accepted true, run_id, state, next_step) and the work runs as a saved run; poll scraper_run_get with run_id. Nothing is charged until it completes, and the same idempotency_key never charges twice.

google_serp_scrape

List retained runs for one tool in the current authenticated scope. Follow next_cursor; input and result payloads are retrieved with scraper_run_get.

scraper_run_list

Extracts HTML metadata, OpenGraph, Twitter Cards, headings, word count, and links from a URL (no JSON-LD/schema). The response also carries final_status, final_url and the redirect chain (status, url, location per hop) so the metadata can be tied to the HTTP response it came from. Credits: 1 per page. The result is returned once and is not retained as a project run; use scraper_run_create for retained background work. If the call would outlast the connection (many items, deep or fresh SERPs) or the platform has no free capacity, it is not failed: the result is an accepted answer (accepted true, run_id, state, next_step) and the work runs as a saved run; poll scraper_run_get with run_id. Nothing is charged until it completes, and the same idempotency_key never charges twice.

html_metadata_extractor

Compares fresh SERPs of a keyword set with the previous observation of the same keywords, country and language to score rank turbulence. Each keyword is a live observation of the top 20 (up to 2 Google pages, 5 credits each). The first observation only saves a baseline: it is free, counts toward the daily live-page allowance and carries NO volatility judgement (baseline_status insufficient_history, volatility_available false, overall_volatility_score, level and algorithm_update_likely null, plus a note); comparison starts with the next check, which measures real movement. Algorithm-update flags are heuristics. The result is returned once and is not retained as a project run; use scraper_run_create for retained background work. If the call would outlast the connection (many items, deep or fresh SERPs) or the platform has no free capacity, it is not failed: the result is an accepted answer (accepted true, run_id, state, next_step) and the work runs as a saved run; poll scraper_run_get with run_id. Nothing is charged until it completes, and the same idempotency_key never charges twice.

serp_volatility_sensor