dataforseo-client 2.1.1 → 2.1.3

package/dist/esm/models/KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo.d.ts

@@ -1,28 +1,26 @@
 export interface IKeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo {
-    /** task identifier of the completed task unique task identifier in our system in the UUID format */
+    /** *task identifier of the completed task* **unique task identifier in our system in the [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format** */
     id?: string | undefined;
-    /** search engine specified when setting the task */
+    /** *search engine specified when setting the task* */
     se?: string | undefined;
     se_type?: string | undefined;
-    /** date when the task was posted (in the UTC format) */
+    /** *date when the task was posted (in the UTC format)* */
     date_posted?: string | undefined;
-    /** user-defined task identifier */
     tag?: string | undefined;
-    /** URL for collecting the results of the task */
+    /** *URL for collecting the results of the task* */
     endpoint?: string | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo implements IKeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo {
-    /** task identifier of the completed task unique task identifier in our system in the UUID format */
+    /** *task identifier of the completed task* **unique task identifier in our system in the [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format** */
     id?: string | undefined;
-    /** search engine specified when setting the task */
+    /** *search engine specified when setting the task* */
     se?: string | undefined;
     se_type?: string | undefined;
-    /** date when the task was posted (in the UTC format) */
+    /** *date when the task was posted (in the UTC format)* */
     date_posted?: string | undefined;
-    /** user-defined task identifier */
     tag?: string | undefined;
-    /** URL for collecting the results of the task */
+    /** *URL for collecting the results of the task* */
     endpoint?: string | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo);

package/dist/esm/models/KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo.js","sourceRoot":"","sources":["../../../src/models/KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,4DAA4D;IAgCrE,YAAY,IAAoE;QAEhF,IAAI,IAAI,EAAE,CAAC;YACP,KAAK,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;oBACvB,IAAK,CAAC,QAAQ,CAAC,GAAS,IAAK,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC;QACL,CAAC;IAED,CAAC;IAED,IAAI,CAAC,IAAU;QACX,IAAI,IAAI,EAAE,CAAC;YACP,KAAK,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;oBAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,IAAS;QACnB,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAG5C,IAAI,MAAM,GAAG,IAAI,4DAA4D,EAAE,CAAC;QAChF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,IAAU;QACb,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAI5C,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}
+{"version":3,"file":"KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo.js","sourceRoot":"","sources":["../../../src/models/KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,4DAA4D;IA6BrE,YAAY,IAAoE;QAEhF,IAAI,IAAI,EAAE,CAAC;YACP,KAAK,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;oBACvB,IAAK,CAAC,QAAQ,CAAC,GAAS,IAAK,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC;QACL,CAAC;IAED,CAAC;IAED,IAAI,CAAC,IAAU;QACX,IAAI,IAAI,EAAE,CAAC;YACP,KAAK,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;oBAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,IAAS;QACnB,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAG5C,IAAI,MAAM,GAAG,IAAI,4DAA4D,EAAE,CAAC;QAChF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,IAAU;QACb,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAI5C,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/esm/models/KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyTaskInfo.d.ts

@@ -1,12 +1,12 @@
 import { KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo } from "./KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo";
 import { BaseResponseTaskInfo, IBaseResponseTaskInfo } from "./BaseResponseTaskInfo";
 export interface IKeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyTaskInfo extends IBaseResponseTaskInfo {
-    /** array of results */
+    /** *array of results* */
     result?: KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo[] | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyTaskInfo extends BaseResponseTaskInfo implements IKeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyTaskInfo {
-    /** array of results */
+    /** *array of results* */
     result?: KeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyResultInfo[] | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsAdTrafficByKeywordsTasksReadyTaskInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsLiveRequestInfo.d.ts

@@ -1,54 +1,54 @@
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsLiveRequestInfo {
-    /** keywords required field The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format Note: Google Ads may return no data for certain groups of keywords visit our Help Center to learn more Also note that Google Ads doesn’t allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can’t use them when setting a task; to learn more about which symbols and characters can be used, please refer to this article learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article */
+    /** *keywords* **required field** The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format **Note:** Google Ads may return no data for certain groups of keywords [visit our Help Center to learn more](https://dataforseo.com/help-center/no-search-volume-data-for-some-keywords) **Also note** that Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task; to learn more about which symbols and characters can be used, please refer to [this article](https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task) learn more about rules and limitations of `keyword` and `keywords` fields in DataForSEO APIs in this [Help Center article](https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis) */
     keywords?: string[] | undefined;
-    /** full name of search engine location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_code or location_coordinate you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: London,England,United Kingdom */
+    /** *full name of search engine location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_code` or `location_coordinate`** you can receive the list of available locations of the search engine with their `location_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `London,England,United Kingdom` */
     location_name?: string | undefined;
-    /** search engine location code optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_coordinate; you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: 2840 */
+    /** *search engine location code* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_coordinate`**; you can receive the list of available locations of the search engines with their `location_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `2840` */
     location_code?: number | undefined;
-    /** GPS coordinates of a location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_code; location_coordinate parameter should be specified in the “latitude,longitude” format; the data will be provided for the country the specified coordinates belong to; example: 52.6178549,-155.352142 */
+    /** *GPS coordinates of a location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_code`**; `location_coordinate` parameter should be specified in the *'latitude,longitude'* format; **the data will be provided for the country the specified coordinates belong to**; example: `52.6178549,-155.352142` */
     location_coordinate?: string | undefined;
-    /** full name of search engine language optional field you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: English */
+    /** *full name of search engine language* optional field you can receive the list of available languages of the search engine with their `language_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `English` */
     language_name?: string | undefined;
-    /** search engine language code optional field you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: en */
+    /** *search engine language code* optional field you can receive the list of available languages of the search engine with their `language_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `en` */
     language_code?: string | undefined;
-    /** include Google search partners optional field if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search; default value: false – results are returned for Google search sites */
+    /** *include Google search partners* optional field if you specify `true`, the results will be delivered for owned, operated, and syndicated networks across [Google and partner sites](https://support.google.com/google-ads/answer/1722047?hl=en) that host Google search; default value: `false` - results are returned for Google search sites */
     search_partners?: boolean | undefined;
-    /** starting date of the time range optional field date format: 'yyyy-mm-dd' minimal value: 4 years from the current date by default, data is returned for the past 12 months; Note: the indicated date cannot be greater than that specified in date_to and/or yesterday’s date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior; if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior */
+    /** *starting date of the time range* optional field date format: `'yyyy-mm-dd'` minimal value: 4 years from the current date by default, data is returned for the past 12 months; **Note**: the indicated date cannot be greater than that specified in `date_to` and/or yesterday's date;if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `false` in the `actual_data` field, `date_from` can be set to the month before last and prior; if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `true` in the `actual_data` field, `date_from` can be set to the last month and prior */
     date_from?: string | undefined;
-    /** ending date of the time range optional field Note: the indicated date cannot be greater than yesterday’s date; if you don’t specify this field, yesterday’s date will be used by default date format: 'yyyy-mm-dd' example: '2022-11-30' */
+    /** *ending date of the time range* optional field **Note:** the indicated date cannot be greater than yesterday's date; if you don't specify this field, yesterday's date will be used by default date format: `'yyyy-mm-dd'` example: `'2022-11-30'` */
     date_to?: string | undefined;
-    /** results sorting parameters optional field Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order default value: relevance */
+    /** *results sorting parameters* optional field Use these parameters to sort the results by `relevance`, `search_volume`, `competition_index`, `low_top_of_page_bid`, or `high_top_of_page_bid` in descending order default value: `relevance` */
     sort_by?: string | undefined;
-    /** include keywords associated with adult content optional field if set to true, adult keywords will be included in the response default value: false note that the API may return no data for such keywords due to Google Ads restrictions */
+    /** *include keywords associated with adult content* optional field if set to `true`, adult keywords will be included in the response default value: `false` **note** that the API may return no data for such keywords due to [Google Ads restrictions](https://support.google.com/adspolicy/answer/6008942?hl=en) */
     include_adult_keywords?: boolean | undefined;
-    /** 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 */
+    /** *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 */
     tag?: string | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsLiveRequestInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsLiveRequestInfo {
-    /** keywords required field The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format Note: Google Ads may return no data for certain groups of keywords visit our Help Center to learn more Also note that Google Ads doesn’t allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can’t use them when setting a task; to learn more about which symbols and characters can be used, please refer to this article learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article */
+    /** *keywords* **required field** The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format **Note:** Google Ads may return no data for certain groups of keywords [visit our Help Center to learn more](https://dataforseo.com/help-center/no-search-volume-data-for-some-keywords) **Also note** that Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task; to learn more about which symbols and characters can be used, please refer to [this article](https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task) learn more about rules and limitations of `keyword` and `keywords` fields in DataForSEO APIs in this [Help Center article](https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis) */
     keywords?: string[] | undefined;
-    /** full name of search engine location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_code or location_coordinate you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: London,England,United Kingdom */
+    /** *full name of search engine location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_code` or `location_coordinate`** you can receive the list of available locations of the search engine with their `location_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `London,England,United Kingdom` */
     location_name?: string | undefined;
-    /** search engine location code optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_coordinate; you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: 2840 */
+    /** *search engine location code* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_coordinate`**; you can receive the list of available locations of the search engines with their `location_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `2840` */
     location_code?: number | undefined;
-    /** GPS coordinates of a location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_code; location_coordinate parameter should be specified in the “latitude,longitude” format; the data will be provided for the country the specified coordinates belong to; example: 52.6178549,-155.352142 */
+    /** *GPS coordinates of a location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_code`**; `location_coordinate` parameter should be specified in the *'latitude,longitude'* format; **the data will be provided for the country the specified coordinates belong to**; example: `52.6178549,-155.352142` */
     location_coordinate?: string | undefined;
-    /** full name of search engine language optional field you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: English */
+    /** *full name of search engine language* optional field you can receive the list of available languages of the search engine with their `language_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `English` */
     language_name?: string | undefined;
-    /** search engine language code optional field you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: en */
+    /** *search engine language code* optional field you can receive the list of available languages of the search engine with their `language_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `en` */
     language_code?: string | undefined;
-    /** include Google search partners optional field if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search; default value: false – results are returned for Google search sites */
+    /** *include Google search partners* optional field if you specify `true`, the results will be delivered for owned, operated, and syndicated networks across [Google and partner sites](https://support.google.com/google-ads/answer/1722047?hl=en) that host Google search; default value: `false` - results are returned for Google search sites */
     search_partners?: boolean | undefined;
-    /** starting date of the time range optional field date format: 'yyyy-mm-dd' minimal value: 4 years from the current date by default, data is returned for the past 12 months; Note: the indicated date cannot be greater than that specified in date_to and/or yesterday’s date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior; if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior */
+    /** *starting date of the time range* optional field date format: `'yyyy-mm-dd'` minimal value: 4 years from the current date by default, data is returned for the past 12 months; **Note**: the indicated date cannot be greater than that specified in `date_to` and/or yesterday's date;if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `false` in the `actual_data` field, `date_from` can be set to the month before last and prior; if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `true` in the `actual_data` field, `date_from` can be set to the last month and prior */
     date_from?: string | undefined;
-    /** ending date of the time range optional field Note: the indicated date cannot be greater than yesterday’s date; if you don’t specify this field, yesterday’s date will be used by default date format: 'yyyy-mm-dd' example: '2022-11-30' */
+    /** *ending date of the time range* optional field **Note:** the indicated date cannot be greater than yesterday's date; if you don't specify this field, yesterday's date will be used by default date format: `'yyyy-mm-dd'` example: `'2022-11-30'` */
     date_to?: string | undefined;
-    /** results sorting parameters optional field Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order default value: relevance */
+    /** *results sorting parameters* optional field Use these parameters to sort the results by `relevance`, `search_volume`, `competition_index`, `low_top_of_page_bid`, or `high_top_of_page_bid` in descending order default value: `relevance` */
     sort_by?: string | undefined;
-    /** include keywords associated with adult content optional field if set to true, adult keywords will be included in the response default value: false note that the API may return no data for such keywords due to Google Ads restrictions */
+    /** *include keywords associated with adult content* optional field if set to `true`, adult keywords will be included in the response default value: `false` **note** that the API may return no data for such keywords due to [Google Ads restrictions](https://support.google.com/adspolicy/answer/6008942?hl=en) */
     include_adult_keywords?: boolean | undefined;
-    /** 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 */
+    /** *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 */
     tag?: string | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsLiveRequestInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsLiveResponseInfo.d.ts

@@ -1,12 +1,12 @@
 import { KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo } from "./KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo";
 import { BaseResponseInfo, IBaseResponseInfo } from "./BaseResponseInfo";
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsLiveResponseInfo extends IBaseResponseInfo {
-    /** array of tasks */
+    /** *array of tasks* */
     tasks?: KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo[] | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsLiveResponseInfo extends BaseResponseInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsLiveResponseInfo {
-    /** array of tasks */
+    /** *array of tasks* */
     tasks?: KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo[] | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsLiveResponseInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo.d.ts

@@ -1,53 +1,53 @@
 import { MonthlySearchesInfo } from "./MonthlySearchesInfo";
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo {
-    /** keyword in a POST array */
+    /** *keyword in a POST array* */
     keyword?: string | undefined;
     spell?: string | undefined;
-    /** location code in a POST array if there is no data, the value is null */
+    /** *location code in a POST array* if there is no data, the value is_`null`n */
     location_code?: number | undefined;
-    /** language code in a POST array if there is no data, the value is null */
+    /** *language code in a POST array* if there is no data, the value is_`null`n */
     language_code?: string | undefined;
-    /** include Google search partners the value you specified when setting the task if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if false, the results are returned for Google search sites only */
+    /** *include Google search partners* the value you specified when setting the task if `true`, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if `false`, the results are returned for Google search sites only */
     search_partners?: boolean | undefined;
-    /** competition represents the relative level of competition associated with the given keyword in paid SERP only possible values: LOW, MEDIUM, HIGH if competition level is unknown, the value is null; learn more about the metric in this help center article */
+    /** *competition* represents the relative level of competition associated with the given keyword in paid SERP only possible values: `LOW`, `MEDIUM`, `HIGH` if competition level is unknown, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition?: string | undefined;
-    /** competition index the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100 the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available if not enough data is available, the value is null; learn more about the metric in this help center article */
+    /** *competition index* the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100 the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available if not enough data is available, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition_index?: number | undefined;
-    /** monthly average search volume rate represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is null */
+    /** *monthly average search volume rate* represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is `null` */
     search_volume?: number | undefined;
-    /** minimum bid for the ad to be displayed at the top of the first page indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *minimum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     low_top_of_page_bid?: number | undefined;
-    /** maximum bid for the ad to be displayed at the top of the first page indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *maximum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     high_top_of_page_bid?: number | undefined;
-    /** cost per click indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
+    /** *cost per click* indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
     cpc?: number | undefined;
-    /** monthly searches represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is null */
+    /** *monthly searches* represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is `null` */
     monthly_searches?: MonthlySearchesInfo[] | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo {
-    /** keyword in a POST array */
+    /** *keyword in a POST array* */
     keyword?: string | undefined;
     spell?: string | undefined;
-    /** location code in a POST array if there is no data, the value is null */
+    /** *location code in a POST array* if there is no data, the value is_`null`n */
     location_code?: number | undefined;
-    /** language code in a POST array if there is no data, the value is null */
+    /** *language code in a POST array* if there is no data, the value is_`null`n */
     language_code?: string | undefined;
-    /** include Google search partners the value you specified when setting the task if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if false, the results are returned for Google search sites only */
+    /** *include Google search partners* the value you specified when setting the task if `true`, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if `false`, the results are returned for Google search sites only */
     search_partners?: boolean | undefined;
-    /** competition represents the relative level of competition associated with the given keyword in paid SERP only possible values: LOW, MEDIUM, HIGH if competition level is unknown, the value is null; learn more about the metric in this help center article */
+    /** *competition* represents the relative level of competition associated with the given keyword in paid SERP only possible values: `LOW`, `MEDIUM`, `HIGH` if competition level is unknown, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition?: string | undefined;
-    /** competition index the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100 the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available if not enough data is available, the value is null; learn more about the metric in this help center article */
+    /** *competition index* the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100 the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available if not enough data is available, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition_index?: number | undefined;
-    /** monthly average search volume rate represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is null */
+    /** *monthly average search volume rate* represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is `null` */
     search_volume?: number | undefined;
-    /** minimum bid for the ad to be displayed at the top of the first page indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *minimum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     low_top_of_page_bid?: number | undefined;
-    /** maximum bid for the ad to be displayed at the top of the first page indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *maximum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     high_top_of_page_bid?: number | undefined;
-    /** cost per click indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
+    /** *cost per click* indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
     cpc?: number | undefined;
-    /** monthly searches represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is null */
+    /** *monthly searches* represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is `null` */
     monthly_searches?: MonthlySearchesInfo[] | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo.d.ts

@@ -1,12 +1,12 @@
 import { KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo } from "./KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo";
 import { BaseResponseTaskInfo, IBaseResponseTaskInfo } from "./BaseResponseTaskInfo";
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo extends IBaseResponseTaskInfo {
-    /** array of results */
+    /** *array of results* */
     result?: KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo[] | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo extends BaseResponseTaskInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo {
-    /** array of results */
+    /** *array of results* */
     result?: KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo[] | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResponseInfo.d.ts

@@ -1,12 +1,12 @@
 import { KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo } from "./KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo";
 import { BaseResponseInfo, IBaseResponseInfo } from "./BaseResponseInfo";
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResponseInfo extends IBaseResponseInfo {
-    /** array of tasks */
+    /** *array of tasks* */
     tasks?: KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo[] | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResponseInfo extends BaseResponseInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResponseInfo {
-    /** array of tasks */
+    /** *array of tasks* */
     tasks?: KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo[] | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResponseInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo.d.ts

@@ -1,53 +1,53 @@
 import { MonthlySearchesInfo } from "./MonthlySearchesInfo";
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo {
-    /** keyword in a POST array */
+    /** *keyword in a POST array* */
     keyword?: string | undefined;
     spell?: string | undefined;
-    /** location code in a POST array if there is no data, the value is null */
+    /** *location code in a POST array* if there is no data, the value is_`null`n */
     location_code?: number | undefined;
-    /** language code in a POST array if there is no data, the value is null */
+    /** *language code in a POST array* if there is no data, the value is_`null`n */
     language_code?: string | undefined;
-    /** include Google search partners the value you specified when setting the task if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if false, the results are returned for Google search sites only */
+    /** *include Google search partners* the value you specified when setting the task if `true`, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if `false`, the results are returned for Google search sites only */
     search_partners?: boolean | undefined;
-    /** competition represents the relative level of competition associated with the given keyword in paid SERP only possible values: LOW, MEDIUM, HIGH if competition level is unknown, the value is null; learn more about the metric in this help center article */
+    /** *competition* represents the relative level of competition associated with the given keyword in paid SERP only possible values: `LOW`, `MEDIUM`, `HIGH` if competition level is unknown, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition?: string | undefined;
-    /** competition index the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100 the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available if not enough data is available, the value is null; learn more about the metric in this help center article */
+    /** *competition index* the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100  the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available  if not enough data is available, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition_index?: number | undefined;
-    /** monthly average search volume rate represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is null */
+    /** *monthly average search volume rate* represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is `null` */
     search_volume?: number | undefined;
-    /** minimum bid for the ad to be displayed at the top of the first page indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *minimum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     low_top_of_page_bid?: number | undefined;
-    /** maximum bid for the ad to be displayed at the top of the first page indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *maximum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     high_top_of_page_bid?: number | undefined;
-    /** cost per click indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
+    /** *cost per click* indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
     cpc?: number | undefined;
-    /** monthly searches represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is null */
+    /** *monthly searches* represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is `null` */
     monthly_searches?: MonthlySearchesInfo[] | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo {
-    /** keyword in a POST array */
+    /** *keyword in a POST array* */
     keyword?: string | undefined;
     spell?: string | undefined;
-    /** location code in a POST array if there is no data, the value is null */
+    /** *location code in a POST array* if there is no data, the value is_`null`n */
     location_code?: number | undefined;
-    /** language code in a POST array if there is no data, the value is null */
+    /** *language code in a POST array* if there is no data, the value is_`null`n */
     language_code?: string | undefined;
-    /** include Google search partners the value you specified when setting the task if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if false, the results are returned for Google search sites only */
+    /** *include Google search partners* the value you specified when setting the task if `true`, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search; if `false`, the results are returned for Google search sites only */
     search_partners?: boolean | undefined;
-    /** competition represents the relative level of competition associated with the given keyword in paid SERP only possible values: LOW, MEDIUM, HIGH if competition level is unknown, the value is null; learn more about the metric in this help center article */
+    /** *competition* represents the relative level of competition associated with the given keyword in paid SERP only possible values: `LOW`, `MEDIUM`, `HIGH` if competition level is unknown, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition?: string | undefined;
-    /** competition index the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100 the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available if not enough data is available, the value is null; learn more about the metric in this help center article */
+    /** *competition index* the competition index for the query indicating how competitive ad placement is for the keyword can take values from 0 to 100  the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available  if not enough data is available, the value is `null`; learn more about the metric in [this help center article](https://dataforseo.com/help-center/what-is-competition) */
     competition_index?: number | undefined;
-    /** monthly average search volume rate represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is null */
+    /** *monthly average search volume rate* represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting if there is no data, the value is `null` */
     search_volume?: number | undefined;
-    /** minimum bid for the ad to be displayed at the top of the first page indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *minimum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     low_top_of_page_bid?: number | undefined;
-    /** maximum bid for the ad to be displayed at the top of the first page indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
+    /** *maximum bid for the ad to be displayed at the top of the first page* indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request */
     high_top_of_page_bid?: number | undefined;
-    /** cost per click indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
+    /** *cost per click* indicates the amount paid (USD) for each click on the ad displayed for a given keyword */
     cpc?: number | undefined;
-    /** monthly searches represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is null */
+    /** *monthly searches* represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations if there is no data, the value is `null` */
     monthly_searches?: MonthlySearchesInfo[] | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo.d.ts

@@ -1,12 +1,12 @@
 import { KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo } from "./KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo";
 import { BaseResponseTaskInfo, IBaseResponseTaskInfo } from "./BaseResponseTaskInfo";
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo extends IBaseResponseTaskInfo {
-    /** array of results */
+    /** *array of results* */
     result?: KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo[] | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo extends BaseResponseTaskInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo {
-    /** array of results */
+    /** *array of results* */
     result?: KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo[] | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo);

package/dist/esm/models/KeywordsDataGoogleAdsKeywordsForKeywordsTaskPostRequestInfo.d.ts

@@ -1,66 +1,66 @@
 export interface IKeywordsDataGoogleAdsKeywordsForKeywordsTaskPostRequestInfo {
-    /** keywords required field The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format Note: Google Ads may return no data for certain groups of keywords visit our Help Center to learn more Also note that Google Ads doesn’t allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can’t use them when setting a task; to learn more about which symbols and characters can be used, please refer to this article learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article */
+    /** *keywords* **required field** The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format **Note:** Google Ads may return no data for certain groups of keywords [visit our Help Center to learn more](https://dataforseo.com/help-center/no-search-volume-data-for-some-keywords) **Also note** that Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task; to learn more about which symbols and characters can be used, please refer to [this article](https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task) learn more about rules and limitations of `keyword` and `keywords` fields in DataForSEO APIs in this [Help Center article](https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis) */
     keywords?: string[] | undefined;
-    /** target website optional field specify a website or URL to get a list of keywords relevant to it; Note: if a website url is specified, you will still get keywords relevant for the entire website */
+    /** *target website* optional field specify a website or URL to get a list of keywords relevant to it; **Note:** if a website url is specified, you will still get keywords relevant for the entire website */
     target?: string | undefined;
-    /** full name of search engine location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_code or location_coordinate you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: London,England,United Kingdom */
+    /** *full name of search engine location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_code` or `location_coordinate`** you can receive the list of available locations of the search engine with their `location_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `London,England,United Kingdom` */
     location_name?: string | undefined;
-    /** search engine location code optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_coordinate; you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: 2840 */
+    /** *search engine location code* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_coordinate`**; you can receive the list of available locations of the search engines with their `location_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `2840` */
     location_code?: number | undefined;
-    /** GPS coordinates of a location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_code; location_coordinate parameter should be specified in the “latitude,longitude” format; the data will be provided for the country the specified coordinates belong to; example: 52.6178549,-155.352142 */
+    /** *GPS coordinates of a location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_code`**; `location_coordinate` parameter should be specified in the *'latitude,longitude'* format; **the data will be provided for the country the specified coordinates belong to**; example: `52.6178549,-155.352142` */
     location_coordinate?: string | undefined;
-    /** full name of search engine language optional field you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: English */
+    /** *full name of search engine language* optional field you can receive the list of available languages of the search engine with their `language_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `English` */
     language_name?: string | undefined;
-    /** search engine language code optional field you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: en */
+    /** *search engine language code* optional field you can receive the list of available languages of the search engine with their `language_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `en` */
     language_code?: string | undefined;
-    /** include Google search partners optional field if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search; default value: false – results are returned for Google search sites */
+    /** *include Google search partners* optional field if you specify `true`, the results will be delivered for owned, operated, and syndicated networks across [Google and partner sites](https://support.google.com/google-ads/answer/1722047?hl=en) that host Google search; default value: `false` - results are returned for Google search sites */
     search_partners?: boolean | undefined;
-    /** starting date of the time range optional field date format: 'yyyy-mm-dd' minimal value: 4 years from the current date by default, data is returned for the past 12 months; Note: the indicated date cannot be greater than that specified in date_to and/or yesterday’s date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior; if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior */
+    /** *starting date of the time range* optional field date format: `'yyyy-mm-dd'` minimal value: 4 years from the current date by default, data is returned for the past 12 months; **Note**: the indicated date cannot be greater than that specified in `date_to` and/or yesterday's date;if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `false` in the `actual_data` field, `date_from` can be set to the month before last and prior; if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `true` in the `actual_data` field, `date_from` can be set to the last month and prior */
     date_from?: string | undefined;
-    /** ending date of the time range optional field Note: the indicated date cannot be greater than yesterday’s date; if you don’t specify this field, yesterday’s date will be used by default date format: 'yyyy-mm-dd' example: '2022-11-30' */
+    /** *ending date of the time range* optional field **Note:** the indicated date cannot be greater than yesterday's date; if you don't specify this field, yesterday's date will be used by default date format: `'yyyy-mm-dd'` example: `'2022-11-30'` */
     date_to?: string | undefined;
-    /** results sorting parameters optional field Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order default value: relevance */
+    /** *results sorting parameters* optional field Use these parameters to sort the results by `relevance`, `search_volume`, `competition_index`, `low_top_of_page_bid`, or `high_top_of_page_bid` in descending order default value: `relevance` */
     sort_by?: string | undefined;
-    /** include keywords associated with adult content optional field if set to true, adult keywords will be included in the response default value: false note that the API may return no data for such keywords due to Google Ads restrictions */
+    /** *include keywords associated with adult content* optional field if set to `true`, adult keywords will be included in the response default value: `false` **note** that the API may return no data for such keywords due to [Google Ads restrictions](https://support.google.com/adspolicy/answer/6008942?hl=en) */
     include_adult_keywords?: boolean | undefined;
-    /** URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request. example: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Note: special characters in postback_url will be urlencoded; i.a., the # character will be encoded into %23 learn more on our Help Center */
+    /** *URL for sending task results* optional field once the task is completed, we will send a POST request with its results compressed in the `gzip` format to the `postback_url` you specified you can use the ‘$id’ string as a `$id` variable and ‘$tag’ as urlencoded `$tag` variable. We will set the necessary values before sending the request. example: `http://your-server.com/postbackscript?id=$id` `http://your-server.com/postbackscript?id=$id&tag=$tag` **Note:** special characters in `postback_url` will be urlencoded; i.a., the `#` character will be encoded into `%23` learn more on our [Help Center](https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api) */
     postback_url?: string | undefined;
-    /** notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request example: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Note: special characters in pingback_url will be urlencoded; i.a., the # character will be encoded into %23 learn more on our Help Center */
+    /** *notification URL of a completed task* optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a `$id` variable and ‘$tag’ as urlencoded `$tag` variable. We will set the necessary values before sending the request example: `http://your-server.com/pingscript?id=$id` `http://your-server.com/pingscript?id=$id&tag=$tag` **Note:** special characters in `pingback_url` will be urlencoded; i.a., the `#` character will be encoded into `%23` learn more on our [Help Center](https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api) */
     pingback_url?: string | undefined;
-    /** 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 */
+    /** *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 */
     tag?: string | undefined;
     [key: string]: any;
 }
 export declare class KeywordsDataGoogleAdsKeywordsForKeywordsTaskPostRequestInfo implements IKeywordsDataGoogleAdsKeywordsForKeywordsTaskPostRequestInfo {
-    /** keywords required field The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format Note: Google Ads may return no data for certain groups of keywords visit our Help Center to learn more Also note that Google Ads doesn’t allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can’t use them when setting a task; to learn more about which symbols and characters can be used, please refer to this article learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article */
+    /** *keywords* **required field** The maximum number of keywords you can specify: 20 The maximum number of characters for each keyword: 80 the keywords you specify will be converted to a lowercase format **Note:** Google Ads may return no data for certain groups of keywords [visit our Help Center to learn more](https://dataforseo.com/help-center/no-search-volume-data-for-some-keywords) **Also note** that Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task; to learn more about which symbols and characters can be used, please refer to [this article](https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task) learn more about rules and limitations of `keyword` and `keywords` fields in DataForSEO APIs in this [Help Center article](https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis) */
     keywords?: string[] | undefined;
-    /** target website optional field specify a website or URL to get a list of keywords relevant to it; Note: if a website url is specified, you will still get keywords relevant for the entire website */
+    /** *target website* optional field specify a website or URL to get a list of keywords relevant to it; **Note:** if a website url is specified, you will still get keywords relevant for the entire website */
     target?: string | undefined;
-    /** full name of search engine location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_code or location_coordinate you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: London,England,United Kingdom */
+    /** *full name of search engine location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_code` or `location_coordinate`** you can receive the list of available locations of the search engine with their `location_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `London,England,United Kingdom` */
     location_name?: string | undefined;
-    /** search engine location code optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_coordinate; you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations example: 2840 */
+    /** *search engine location code* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_coordinate`**; you can receive the list of available locations of the search engines with their `location_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/locations` example: `2840` */
     location_code?: number | undefined;
-    /** GPS coordinates of a location optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; if you use this field, you don’t need to specify location_name or location_code; location_coordinate parameter should be specified in the “latitude,longitude” format; the data will be provided for the country the specified coordinates belong to; example: 52.6178549,-155.352142 */
+    /** *GPS coordinates of a location* optional field if you do not indicate the location, you will receive worldwide results, i.e., for all available locations; **if you use this field, you don't need to specify `location_name` or `location_code`**; `location_coordinate` parameter should be specified in the *'latitude,longitude'* format; **the data will be provided for the country the specified coordinates belong to**; example: `52.6178549,-155.352142` */
     location_coordinate?: string | undefined;
-    /** full name of search engine language optional field you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: English */
+    /** *full name of search engine language* optional field you can receive the list of available languages of the search engine with their `language_name` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `English` */
     language_name?: string | undefined;
-    /** search engine language code optional field you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages example: en */
+    /** *search engine language code* optional field you can receive the list of available languages of the search engine with their `language_code` by making a separate request to `https://api.dataforseo.com/v3/keywords_data/google_ads/languages` example: `en` */
     language_code?: string | undefined;
-    /** include Google search partners optional field if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search; default value: false – results are returned for Google search sites */
+    /** *include Google search partners* optional field if you specify `true`, the results will be delivered for owned, operated, and syndicated networks across [Google and partner sites](https://support.google.com/google-ads/answer/1722047?hl=en) that host Google search; default value: `false` - results are returned for Google search sites */
     search_partners?: boolean | undefined;
-    /** starting date of the time range optional field date format: 'yyyy-mm-dd' minimal value: 4 years from the current date by default, data is returned for the past 12 months; Note: the indicated date cannot be greater than that specified in date_to and/or yesterday’s date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior; if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior */
+    /** *starting date of the time range* optional field date format: `'yyyy-mm-dd'` minimal value: 4 years from the current date by default, data is returned for the past 12 months; **Note**: the indicated date cannot be greater than that specified in `date_to` and/or yesterday's date;if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `false` in the `actual_data` field, `date_from` can be set to the month before last and prior; if [Status endpoint](/v3/keywords_data/google_ads/status/) returns `true` in the `actual_data` field, `date_from` can be set to the last month and prior */
     date_from?: string | undefined;
-    /** ending date of the time range optional field Note: the indicated date cannot be greater than yesterday’s date; if you don’t specify this field, yesterday’s date will be used by default date format: 'yyyy-mm-dd' example: '2022-11-30' */
+    /** *ending date of the time range* optional field **Note:** the indicated date cannot be greater than yesterday's date; if you don't specify this field, yesterday's date will be used by default date format: `'yyyy-mm-dd'` example: `'2022-11-30'` */
     date_to?: string | undefined;
-    /** results sorting parameters optional field Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order default value: relevance */
+    /** *results sorting parameters* optional field Use these parameters to sort the results by `relevance`, `search_volume`, `competition_index`, `low_top_of_page_bid`, or `high_top_of_page_bid` in descending order default value: `relevance` */
     sort_by?: string | undefined;
-    /** include keywords associated with adult content optional field if set to true, adult keywords will be included in the response default value: false note that the API may return no data for such keywords due to Google Ads restrictions */
+    /** *include keywords associated with adult content* optional field if set to `true`, adult keywords will be included in the response default value: `false` **note** that the API may return no data for such keywords due to [Google Ads restrictions](https://support.google.com/adspolicy/answer/6008942?hl=en) */
     include_adult_keywords?: boolean | undefined;
-    /** URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request. example: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Note: special characters in postback_url will be urlencoded; i.a., the # character will be encoded into %23 learn more on our Help Center */
+    /** *URL for sending task results* optional field once the task is completed, we will send a POST request with its results compressed in the `gzip` format to the `postback_url` you specified you can use the ‘$id’ string as a `$id` variable and ‘$tag’ as urlencoded `$tag` variable. We will set the necessary values before sending the request. example: `http://your-server.com/postbackscript?id=$id` `http://your-server.com/postbackscript?id=$id&tag=$tag` **Note:** special characters in `postback_url` will be urlencoded; i.a., the `#` character will be encoded into `%23` learn more on our [Help Center](https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api) */
     postback_url?: string | undefined;
-    /** notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request example: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Note: special characters in pingback_url will be urlencoded; i.a., the # character will be encoded into %23 learn more on our Help Center */
+    /** *notification URL of a completed task* optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a `$id` variable and ‘$tag’ as urlencoded `$tag` variable. We will set the necessary values before sending the request example: `http://your-server.com/pingscript?id=$id` `http://your-server.com/pingscript?id=$id&tag=$tag` **Note:** special characters in `pingback_url` will be urlencoded; i.a., the `#` character will be encoded into `%23` learn more on our [Help Center](https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api) */
     pingback_url?: string | undefined;
-    /** 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 */
+    /** *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 */
     tag?: string | undefined;
     [key: string]: any;
     constructor(data?: IKeywordsDataGoogleAdsKeywordsForKeywordsTaskPostRequestInfo);