% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/stevenblack_cat.R
\name{stevenblack_cat}
\alias{stevenblack_cat}
\title{Get Category from Steven Black's Host List}
\usage{
stevenblack_cat(domain = NULL, use_file = NULL)
}
\arguments{
\item{domain}{domain names as character vector}

\item{use_file}{path to a local Steven Black hosts file. If NULL, downloads from GitHub
once per session and reuses it}
}
\value{
data.frame with the original domain name, the category, and the date of the
  list that supplied it
}
\description{
Classifies domains based on Steven Black's unified host list which blocks
ads, malware, and tracking domains. The function checks if a domain appears
in the blocklist and categorizes it accordingly.
}
\details{
Steven Black's host list is a consolidated list from multiple sources including
adaway.org, mvps.org, malwaredomainlist.com, and someonewhocares.org.

Unlike the Shallalist and DMOZ lookups, this list is actively maintained, so the
returned \code{source_last_published} is the fetched file's own modification date
rather than a constant. See \code{\link{source_vintage}}.
}
\examples{
\dontrun{
stevenblack_cat("doubleclick.net")
stevenblack_cat(c("google.com", "googleadservices.com", "malware-example.com"))
}
}
\references{
\url{https://github.com/StevenBlack/hosts}
}
\seealso{
\code{\link{source_vintage}} for the provenance of every category source
}
