Bing Search Volume Live

{
  "$defs": {
    "KeywordsDataBingSearchVolumeLiveRequestInfo": {
      "properties": {
        "date_from": {
          "anyOf": [
            {
              "description": "starting date of the time rangeoptional fieldminimal value: 24 months from today's date;if you don't specify this field, data will be provided for the last 12 months;minimum value: two years 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 rec",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "date_to": {
          "anyOf": [
            {
              "description": "ending date of the time rangeoptional fieldif you don't specify this field, data will be provided for the last 12 months;minimum value: two years back from today’s date;maximum value: one month from today's date;note: we do not recommend using a custom time range for the past year's dates;date format: \"yyyy-mm-dd\"example:\"2020-03-15\"Note: we do not recommend using a custom time range for the past year's dates",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "device": {
          "anyOf": [
            {
              "description": "device typeoptional fieldspecify this field if you want to get the data for a particular device type;possible values: all, mobile, desktop, tabletdefault value: all",
              "type": "string"
            },
            {
              "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_namesupported languages:en, fr, de",
          "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_codesupported languages:English, French, German",
          "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"
        },
        "search_partners": {
          "anyOf": [
            {
              "description": "Bing search partners typeoptional fieldif you specify true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.default value: false - results are returned for Bing, AOL, and Yahoo search networks",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "sort_by": {
          "anyOf": [
            {
              "description": "results sorting parametersoptional fieldUse these parameters to sort the results by search_volume, cpc, competition or relevance in the descending orderdefault value: relevance",
              "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/KeywordsDataBingSearchVolumeLiveRequestInfo"
              }
            ],
            "type": "object"
          },
          {
            "type": "null"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}