Own organic ranking keywords
dataforseo · runnable · billing paged
| Fact | Value |
|---|---|
| Provider | dataforseo |
| Module | base |
| Runnable today | Yes — a quantity-bound adapter exists |
| API path | /v3/dataforseo_labs/google/ranked_keywords/live |
| Billing kind | paged |
| Price status | Known — a published or measured rate is recorded |
| Availability | Executable in selected plans; target and quantity bounds required |
| Query contract | Enforced — the collector reads these parameters from the contract |
| Catalogue research date | 2026-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
| Component | Value |
|---|---|
task_usd | 0.012 |
returned_item_usd | 0.00012 |
clickstream_multiplier_off | 1 |
clickstream_multiplier_on | 2 |
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
| Limit | Value |
|---|---|
quantity | 50000 |
groups | 1 |
Frozen acquisition parameters
The customer's own footprint is the deliverable, so no server-side row filter is applied: a filtered own-ranking set would understate the brand's real position inventory and would make the time series a measure of the filter rather than of the brand. Cost is bounded by the selected limit, not by a threshold.
| Parameter | Value |
|---|---|
| Fixed parameters | {"item_types":["organic"],"include_clickstream_data":false,"historical_serp_mode":"live","ignore_synonyms":false,"load_rank_absolute":true} |
| Server-side filters | None |
| Order by | ["keyword_data.keyword_info.search_volume,desc"] |
| Page window | 1000 |
| Varies by target | target |
Evidence: VERIFIED 2026-09-14 against https://docs.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live/, fetched and quoted in docs/plans/brand-studio-roadmap/query-contract-doc-verification-20260914.json. Both load_rank_absolute and item_types are documented optional fields on this endpoint. Documented effect of load_rank_absolute: it adds a metrics_absolute rankings distribution; it is not a claim about per-row rank_absolute.
Open audit flags: Documentation proves both parameters exist and are optional on this endpoint. It does not prove the provider accepts them in ONE request body; only a real request does.
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.