Search Dataset Articles

curl -G https://api.runcaptain.com/v2/datasets/nytimes/search \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "X-Organization-ID: YOUR_ORG_UUID" \
     --data-urlencode "q=artificial intelligence" \
     -d limit=5

{
  "dataset": "nytimes",
  "query": "artificial intelligence",
  "results": [
    {
      "title": "How AI Is Transforming the Tech Industry",
      "url": "https://www.nytimes.com/2024/01/15/technology/ai-transformation.html",
      "snippet": "Artificial intelligence continues to reshape how companies build and deploy software...",
      "date": "Jan 15, 2024",
      "source": "New York Times"
    },
    {
      "title": "The Future of Work in an AI World",
      "url": "https://www.nytimes.com/2024/01/10/business/ai-future-work.html",
      "snippet": "As AI capabilities expand, workers and employers alike are adapting to new realities...",
      "date": "Jan 10, 2024",
      "source": "New York Times"
    }
  ],
  "total_results": 15400,
  "limit": 5
}

Search for articles within a news dataset.

Uses Google Search constrained to the dataset’s domain to find relevant articles.

Supported Datasets

nytimes: New York Times (nytimes.com)
washpost: Washington Post (washingtonpost.com)
sfstandard: SF Standard (sfstandard.com)

Response

Returns a list of search results with title, URL, snippet, and date.

Search for articles within a news dataset. Uses Google Search constrained to the dataset's domain to find relevant articles. ## Supported Datasets - **nytimes**: New York Times (nytimes.com) - **washpost**: Washington Post (washingtonpost.com) - **sfstandard**: SF Standard (sfstandard.com) ## Response Returns a list of search results with title, URL, snippet, and date.

Path parameters

datasetenumRequired

The news dataset to search. Supported: nytimes, washpost, sfstandard

Allowed values:

Query parameters

qstringRequired

Search query

limitintegerOptional1-100Defaults to 10

Maximum number of results to return (default: 10, max: 100)

Response

Search completed successfully

datasetenum

The dataset that was searched

Allowed values:

querystring

Original search query

resultslist of objects

List of search results

total_resultsinteger

Total number of results available

limitinteger

Maximum results requested

errorstring or null

Error message if search failed

Search Dataset Articles

Supported Datasets

Response

Path parameters

Headers

Query parameters

Response

Errors

Supported Datasets

Response