{"type":"api","title":"Get Domain Volume","meta":{"id":"/apps/pubhub/media/legacy-umbrella-api/bf58de618cbb72dda8f39b0414ce94c0a15cd467/f963d12c-70c5-3340-bb7c-d5cff60c643a","info":{"title":"Investigate API","description":"Umbrella Investigate API","version":"1.1.4","contact":{"name":"Cloud Security Developer Community"}},"security":[{"bearerAuth":[]}],"tags":[{"name":"Domain Status and Categorization"},{"name":"Domain Volume"},{"name":"Co-occurrences for a Domain"},{"name":"Passive DNS"},{"name":"Tagging Timeline"},{"name":"Subdomains for a Domain"},{"name":"Related Domains for a Domain"},{"name":"Security Information for a Domain"},{"name":"AS Information for a Domain"},{"name":"WHOIS Information for a Domain"},{"name":"Umbrella Popularity List-Top Million Domains"},{"name":"Search Domain"},{"name":"Cisco Secure Malware Analytics Integration"}],"x-parser-conf":{"overview":{"markdownPath":"investigate/investigate-explorer-overview.md"}},"openapi":"3.0.0","servers":[{"url":"https://investigate.api.umbrella.com"}],"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"spec":{"summary":"Get Domain Volume","operationId":"getDomainVolume","tags":["Domain Volume"],"description":"List the query volume for a domain for the last 30 days.\nIf there is no information about the domain, Umbrella Investigate returns an empty array.\nAs the query takes time to generate, the last two hours may be blank.\n","parameters":[{"name":"domain","in":"path","required":true,"description":"A domain name. For example, 'cisco.com'.","schema":{"type":"string"},"$$ref":"#/components/parameters/domainParam"},{"name":"start","in":"query","required":false,"description":"Point in time in the past, expressed as a timestamp in milliseconds\nor relative time. Valid formats: start=-2days, start=-2hours start=1509332100000.\nThe maximum time range is 30 days.","schema":{"type":"string"}},{"name":"stop","in":"query","required":false,"description":"Point in time in the past expressed as a timestamp in milliseconds\nor relative time. Valid formats: stop=-1days, stop=now, stop=1509642000000.\nThe maximum time range is 30 days.","schema":{"type":"string"}},{"name":"match","in":"query","required":false,"description":"Valid options are: 'exact', 'component', or 'all' which is the default value.","schema":{"type":"string"}}],"responses":{"200":{"description":"Everything worked as expected.","content":{"application/json":{"schema":{"type":"object","properties":{"dates":{"type":"array","items":{"type":"string"},"description":"Date and time recorded for this domain expressed in Unix epoch time."},"queries":{"type":"array","items":{"type":"string"},"description":"Number of DNS queries for the domain per hour, listed in ascending order."}}},"example":{"dates":["1510873200000","1510959600000"],"queries":["1378426","1361934","1308188","1238823","1245126","1215994","1256917","1200190","1245963","1355719","1332685","1319825","1362464","1457174","1695448"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/400Error"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/401Error"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/403Error"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/404Error"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/500Error"}},"__originalOperationId":"getDomainVolume","security":[{"bearerAuth":[]}],"method":"get","path":"/domains/volume/{domain}"}}