# Subdomains of a domain with Google rank distribution

This endpoint will provide you with a list of subdomains of the specified domain, along with the ranking distribution across organic and paid search.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-dataforseo-labs-google-subdomains-live` |
| Platform | [Google](https://www.orcarouter.ai/tools/google.md) |
| Capability | [Ranking positions](https://www.orcarouter.ai/tools/google/seo-rankings.md) |
| Price | $0.013596 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `filters` | array | no | array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, \<, \<=, >, >=, =, \<>, in, not_in example: \["metrics.paid.count",">",0\] |
| `historical_serp_mode` | string | no | data collection mode optional field you can use this field to filter the results; possible types of filtering: live — return metrics for SERPs in which the specified target currently has ranking results; lost — return metrics for SERPs in which the specified target had previously had ranking results |
| `ignore_synonyms` | boolean | no | ignore highly similar keywords optional field if set to true, only core keywords will be returned, all highly similar keywords will be excluded; default value: false |
| `include_clickstream_data` | boolean | no | include or exclude data from clickstream-based metrics in the result optional field if the parameter is set to true, you will receive clickstream_etv, clickstream_gender_distribution, and clickstream_age_distribution fields with clickstream data in the response default value: false with this paramet |
| `item_types` | array | no | display results by item type optional field indicates the type of search results included in the response Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array; you will not be able to sort and filter result |
| `language_code` | string | no | language code optional field if you use this field, you don’t need to specify language_name you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ignore this field to get the |
| `language_name` | string | no | full name of the language optional field if you use this field, you don’t need to specify language_code you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ignore this field |
| `limit` | integer | no | the maximum number of returned keywords optional field default value: 100 maximum value: 1000 |
| `location_code` | integer | no | location code optional field if you use this field, you don’t need to specify location_name you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ignore this field to get the |
| `location_name` | string | no | full name of the location optional field if you use this field, you don’t need to specify location_code you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ignore this field |
| `offset` | integer | no | offset in the results array of returned keywords optional field default value: 0 if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords |
| `order_by` | array | no | results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc – results will be sorted in the ascending order desc – results will be sorted in the descending order you should use a comma to specify a sorting type example: \["m |
| `tag` | string | no | user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response |
| `target` | string | no | domain required field the domain name of the target website the domain should be specified without https:// and www. |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-dataforseo-labs-google-subdomains-live/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/dataforseo.x-dataforseo-labs-google-subdomains-live/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Keywords a domain ranks for in Google — position, volume](https://www.orcarouter.ai/tools/google/seo-rankings/google-domain-ranked-keywords.md) | — | $0.0132 per call | OK |
| [Ranking metrics for up to 1000 Google Play apps](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-bulk-app-metrics-live.md) | — | $0.013464 per call | OK |
| [Google product categories a domain ranks in](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-categories-for-domain-live.md) | — | $0.013596 per call | OK |
| [Keywords two domains both rank for in Google](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-domain-intersection-live.md) | — | $0.013596 per call | OK |
| [Keywords several pages rank for together, by URL](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-page-intersection-live.md) | — | $0.013596 per call | OK |
| [Top ranking pages of a domain in Google](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-relevant-pages-live.md) | — | $0.013596 per call | OK |
| [Domains ranking in Google for your keywords](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-serp-competitors-live.md) | — | $0.01386 per call | OK |
| [Keywords several Google Play apps rank for together](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-app-intersection-live.md) | — | $0.01452 per call | OK |
| [Keywords a Google Play app ranks for, by app id](https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-keywords-for-app-live.md) | — | $0.01452 per call | OK |

## FAQ

### How much does Subdomains of a domain with Google rank distribution cost?

Subdomains of a domain with Google rank distribution costs $0.013596 per call: 1,000 calls cost $13.596.

### What does a $10 budget buy with Subdomains of a domain with Google rank distribution?

About 735 calls at $0.013596 per call.

### What inputs does Subdomains of a domain with Google rank distribution need?

It has no required inputs.

### How do I call Subdomains of a domain with Google rank distribution?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/google/seo-rankings/x-dataforseo-labs-google-subdomains-live