Bing Search Volume History Live

{
  "$defs": {
    "KeywordsDataBingSearchVolumeHistoryLiveRequestInfo": {
      "properties": {
        "date_from": {
          "anyOf": [
            {
              "description": "starting date of the time rangeoptional fieldminimum value: 24 months back from today’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;date format: \"yyyy-mm-dd\"example:\"2020-01-01\"Note: we do not recommend using a custom time range;Note 2: if date_from and date_to parameters are not specified, the data will be returned",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "date_to": {
          "anyOf": [
            {
              "description": "ending date of the time rangeoptional fieldminimum value: two years back from today’s date;maximum value: one day from today's date;date format: \"yyyy-mm-dd\"example:\"2020-03-15\"Note: we do not recommend using a custom time rangeNote 2: if date_from and date_to parameters are not specified, the data will be returned for the past 24 monthsif you specify the period parameter:with value weekly, you will get results for the past 15 weekswith value daily, you will get results for the past 45 days",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "device": {
          "anyOf": [
            {
              "description": "device typesoptional fieldspecify this field if you want to get the data for a particular device typespossible values: mobile, desktop, tablet, non_smartphonesdefault value: [\"mobile\", \"desktop\", \"tablet\", \"non_smartphones\"]",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "keywords": {
          "description": "keywordsrequired fieldThe maximum number of keywords you can specify: 1000The maximum number of characters for each keyword: 100the specified keywords will be converted to lowercase, data will be provided in a separate arraylearn more about rules and limitations of keyword and keywords fields in Asale APIs in this Help Center article",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "language_code": {
          "description": "search engine language coderequired field if you don't specify language_nameif you use this field, you don't need to specify language_nameyou can receive the list of available languages of the search engines with their language_code by making a separate request to",
          "type": "string"
        },
        "language_name": {
          "description": "full name of search engine languagerequired field if you don't specify language_codeif you use this field, you don't need to specify language_codeyou can receive the list of available languages of the search engines with their language_code by making a separate request to",
          "type": "string"
        },
        "location_code": {
          "description": "search engine location coderequired field if you don't specify location_name or location_coordinateif you use this field, you don't need to specify location_name or location_coordinateyou can receive the list of available locations of the search engines with their location_code by making a separate request to",
          "type": "integer"
        },
        "location_coordinate": {
          "description": "GPS coordinates of a locationrequired field if you don't specify location_name or location_codeif you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" formatthe data will be provided for the country the specified coordinates belong toexample:52.6178549,-155.352142",
          "type": "string"
        },
        "location_name": {
          "description": "full name of search engine locationrequired field if you don't specify location_code or location_coordinateif you use this field, you don't need to specify location_code or location_coordinateyou can receive the list of available locations of the search engine with their location_name by making a separate request to Kingdom",
          "type": "string"
        },
        "period": {
          "anyOf": [
            {
              "description": "aggregates the returned data to a certain time periodoptional fieldspecify this field if you want to get the data in monthly, weekly or daily formatpossible values: monthly, weekly, dailymonthly - returns data up to past 24 monthsweekly - returns data up to past 15 weeksdaily - returns data up to past 45 daysdefault value: monthly",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "tag": {
          "anyOf": [
            {
              "description": "user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "body": {
      "items": {
        "anyOf": [
          {
            "oneOf": [
              {
                "$ref": "#/$defs/KeywordsDataBingSearchVolumeHistoryLiveRequestInfo"
              }
            ],
            "type": "object"
          },
          {
            "type": "null"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}