Search Dataset
Search for articles within a news dataset.
Performs search constrained to the dataset's domain.
**Supported Datasets:**
- `nytimes`: New York Times (nytimes.com)
- `washpost`: Washington Post (washingtonpost.com)
- `sfstandard`: SF Standard (sfstandard.com)
- `sacbee`: Sacramento Bee (sacbee.com)
- `sfchronicle`: San Francisco Chronicle (sfchronicle.com)
- `newyorker`: The New Yorker (newyorker.com)
- `theatlantic`: The Atlantic (theatlantic.com)
- `sjmercury`: San Jose Mercury News (mercurynews.com)
- `latimes`: Los Angeles Times (latimes.com)
- `wired`: WIRED (wired.com)
- `scientificamerican`: Scientific American (scientificamerican.com)
**Headers:**
- `Authorization`: Bearer {api_key} - Captain API key for authentication
- `X-Organization-ID`: Organization UUID
**Query Parameters:**
- `q`: Search query (required)
- `limit`: Maximum results to return (default: 10, max: 100)
**Returns:**
List of search results with title, URL, snippet, and date.
**Example:**
```
GET /v2/datasets/nytimes/search?q=artificial+intelligence&limit=5
```
Path parameters
dataset
The news dataset to search
Query parameters
q
Search query
limit
Maximum number of results to return
Response
Successful Response
dataset
query
error
Error message if search failed
limit
results
total_results
Errors
400
Search Dataset Request Bad Request Error
401
Search Dataset Request Unauthorized Error
403
Search Dataset Request Forbidden Error
500
Search Dataset Request Internal Server Error
502
Search Dataset Request Bad Gateway Error
503
Search Dataset Request Service Unavailable Error
504
Search Dataset Request Gateway Timeout Error