Brand Studio docs
Engineering manualAcquisition and cost

Selected rival ranking exports

dataforseo · runnable · billing paged

FactValue
Providerdataforseo
Modulebase
Runnable todayYes — a quantity-bound adapter exists
API path/v3/dataforseo_labs/google/ranked_keywords/live
Billing kindpaged
Price statusKnown — a published or measured rate is recorded
AvailabilityExecutable in selected plans; target and quantity bounds required
Query contractEnforced — the collector reads these parameters from the contract
Catalogue research date2026-09-07

Billing formula

What the provider charges for one request of this item. Provider cost is not the customer price and is not an account balance movement; the three are different numbers and this is the first of them.

sum_request((0.012 + 0.00012*returned_items_request)*clickstream_multiplier_request)

Rates

ComponentValue
task_usd0.012
returned_item_usd0.00012
clickstream_multiplier_off1
clickstream_multiplier_on2

Minimum charge: {"active_task_base_usd":"0.012"}

Provider limits: {"items_per_request":1000}

Rate verification: verified_published.

Caveat: Each offset/cursor request repeats the task fee; group by endpoint, target, location and language. include_clickstream_data=true doubles the applicable request cost.

Runtime limits

LimitValue
quantity10000
groups10

Frozen acquisition parameters

A rival's genuine ranking inventory is what it ranks for on page one or two. Fixed ceiling, identical for every brand and every run.

ParameterValue
Fixed parameters{"item_types":["organic"],"include_clickstream_data":false,"historical_serp_mode":"live","ignore_synonyms":false,"load_rank_absolute":true}
Server-side filters[["ranked_serp_element.serp_item.rank_group","<=",20]]
Order by["keyword_data.keyword_info.search_volume,desc"]
Page window1000
Varies by targettarget

Changed in contract v1 (ACQ-1): Labs bills 0.012 + 0.00012 per returned row, so a server-side filter is the only real cost lever. Rows where the rival sits past page two were being bought and then discarded downstream.

Included in levels: Snapshot, Market, Deep.

Dated sources

  • https://dataforseo.com/pricing/dataforseo-labs/dataforseo-google-api (read 2026-09-07)
  • https://docs.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live/ (read 2026-09-07)

Notes from the catalogue

  • Each offset/cursor request repeats the task fee; group by endpoint, target, location and language. include_clickstream_data=true doubles the applicable request cost.

On this page