Search for your HITs and return those HITs as R objects.
SearchHITs(response.group = NULL, return.all = TRUE,
pagenumber = "1", pagesize = "10",
sortproperty = "Enumeration", sortdirection = "Ascending",
return.hit.dataframe = TRUE, return.qual.dataframe = TRUE,
verbose = getOption('MTurkR.verbose', TRUE), ...)
An optional character string (or vector of character strings) specifying what details of each HIT to return of: “Request”, “Minimal”, “HITDetail”, “HITQuestion”, “HITAssignmentSummary”. For more information, see Common Parameters and HIT Data Structure.
A logical indicating whether all HITs (as opposed to a specified page of the search results) should be returned. Default is TRUE
.
An optional character string indicating which page of search results should be returned. Most users can ignore this.
An optional character string indicating how many search results should be returned by each request, between 1 and 100. Most users can ignore this.
One of “Title”, “Reward”, “Expiration”, “CreationTime”, “Enumeration”. Ignored if return.all=TRUE
. Most users can ignore this.
Either “Ascending” or “Descending”. Ignored if return.all=TRUE
. Most users can ignore this.
A logical indicating whether the data frame of HITs should be returned. Default is TRUE
.
A logical indicating whether the list of each HIT's QualificationRequirements (stored as data frames in that list) should be returned. Default is TRUE
.
Optionally print the results of the API request to the standard output. Default is taken from getOption('MTurkR.verbose', TRUE)
.
Additional arguments passed to request
.
A list one- or two-element list containing a data frame of HIT details and, optionally (if `return.qual.dataframe = TRUE`), a list of each HIT's QualificationRequirements (stored as data frames in that list).
Retrieve your current HITs (and, optionally, characteristics thereof). To view HITs on the MTurk requester website, see OpenManageHITPage
. To view HITs on the MTurk worker website, use ViewAvailableHITs
.
searchhits()
is an alias.