# Domain metric trends for product categories

This endpoint will provide you with dynamics of change in metrics of domains relevant to the specified product and service categories.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-dataforseo-labs-google-domain-metrics-by-categories-live` |
| Platform | [Google](https://www.orcarouter.ai/tools/google.md) |
| Capability | [Search trends](https://www.orcarouter.ai/tools/google/keywords-trends.md) |
| Price | $0.13596 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `category_codes` | array | no | product and service categories required field The maximum number of categories you can specify: 5 you can download the full list of possible categories |
| `correlate` | boolean | no | correlate data with previously obtained datasets optional field default value: true; if you use this parameter, our system will correlate data you obtain now with previously obtained datasets; this parameter is intended to mitigate any inconsistencies that may result from changes to our database; No |
| `etv_max` | integer | no | maximum current organic ETV of the domain optional field if specified, the API will return only domains with organic_etv lesser than the specified value |
| `etv_min` | integer | no | minimum current organic ETV of the domain optional field if specified, the API will return only domains with organic_etv greater than the specified value |
| `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, match, not_match, ilike, not_ilike, |
| `first_date` | string | no | first date of comparison period required field first date for which domain metrics will be provided; date format: "yyyy-mm-dd"; example: "2021-06-01"; the list available dates is available through the available history endpoint; Note: first_date cannot be greater than today’s date; Also note: the da |
| `include_subdomains` | boolean | no | return subdomains in the API response optional field if false, the API response will contain main_domain only; if true, the API will return main_domain plus its subdomains (if available); default value: true |
| `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 the organic object, the results will be ordered by the first item type in the array; you will not be able to sort and f |
| `language_code` | string | no | unique language identifier required field if you don’t specify language_name Note: it is required to specify either language_name or language_code; you can receive the list of available languages with their language_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/l |
| `language_name` | string | no | full name of the language required field if you don’t specify language_code Note: it is required to specify either language_name or language_code; you can receive the list of available languages with their language_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/lo |
| `limit` | integer | no | the maximum number of domains in the results array optional field default value: 100; maximum value: 1000 |
| `location_code` | integer | no | unique location identifier required field if you don’t specify location_name Note: it is required to specify either location_name or location_code; you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/l |
| `location_name` | string | no | full name of the location required field if you don’t specify location_code Note: it is required to specify either location_name or location_code; you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/lo |
| `offset` | integer | no | offset in the results array of returned domains optional field default value: 0; if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains |
| `order_by` | array | no | results sorting rules optional field you can use the same values as in the filters array to sort the results; default rule: \["organic_etv,desc"\]; possible sorting types: asc – results will be sorted in ascending order desc – results will be sorted in descending order; you should use a comma to set u |
| `second_date` | string | no | second date of comparison period required field second date for which domain metrics will be provided; date format: "yyyy-mm-dd"; example: "2021-10-01"; the list available dates is available through the available history endpoint; Note: second_date cannot be greater than today’s date; Also note: the |
| `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 |
| `top_categories_count` | integer | no | number of additional domain categories optional field by using this parameter, you can receive domains relevant to additional categories that are not specified in category_codes above; to learn more about the parameter, please refer to this help center article; by default, top_categories_count is eq |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-dataforseo-labs-google-domain-metrics-by-categories-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-domain-metrics-by-categories-live/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [DataForSEO Trends keyword popularity over time](https://www.orcarouter.ai/tools/google/keywords-trends/x-keywords-data-dataforseo-trends-explore-live.md) | — | $0.00132 per call | OK |
| [Google Trends keyword popularity over time](https://www.orcarouter.ai/tools/google/keywords-trends/x-keywords-data-google-trends-explore-live.md) | — | $0.0121 per call | OK |
| [Google Trends interest over time for search terms](https://www.orcarouter.ai/tools/google/keywords-trends/x-google-trends.md) | — | $0.0275 per call | OK |

## FAQ

### How much does Domain metric trends for product categories cost?

Domain metric trends for product categories costs $0.13596 per call: 1,000 calls cost $135.96.

### What does a $10 budget buy with Domain metric trends for product categories?

About 73 calls at $0.13596 per call.

### What inputs does Domain metric trends for product categories need?

It has no required inputs.

### How do I call Domain metric trends for product categories?

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/keywords-trends/x-dataforseo-labs-google-domain-metrics-by-categories-live