Batch Search Datasets

import requests
BASE_URL = "https://api.filesearch.dev"
API_KEY = "your_api_key"
headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.post(
    f"{BASE_URL}/v2/datasets/batch-search",
    headers=headers,
    json={"q": "BRCA1", "datasets": ["nejm"], "limit": 2},
    timeout=75.0
)
print(response.json())

{
  "query": "BRCA1",
  "datasets_searched": [
    "nejm"
  ],
  "errors": {},
  "results": [
    {
      "title": "Bevacizumab for BRCA1/2 -Mutated Triple-Negative Breast Cancer",
      "url": "https://clinician.nejm.org/nejm-jw.NA47412?show-author=true&author-id=AU1223",
      "author": null,
      "date": "06/27/2026, 07:00 PM, +0000 UTC",
      "snippet": null,
      "source": "NEJM"
    },
    {
      "title": "Adjuvant Olaparib for Patients with BRCA1 - or BRCA2 -Mutated Breast Cancer",
      "url": "https://www.nejm.org/doi/full/10.1056/NEJMoa2105215",
      "author": null,
      "date": "06/03/2021, 07:00 AM, +0000 UTC",
      "snippet": null,
      "source": "NEJM"
    }
  ],
  "results_by_dataset": {
    "nejm": [
      {
        "title": "Bevacizumab for BRCA1/2 -Mutated Triple-Negative Breast Cancer",
        "url": "https://clinician.nejm.org/nejm-jw.NA47412?show-author=true&author-id=AU1223",
        "author": null,
        "date": "06/27/2026, 07:00 PM, +0000 UTC",
        "snippet": null,
        "source": "NEJM"
      },
      {
        "title": "Adjuvant Olaparib for Patients with BRCA1 - or BRCA2 -Mutated Breast Cancer",
        "url": "https://www.nejm.org/doi/full/10.1056/NEJMoa2105215",
        "author": null,
        "date": "06/03/2021, 07:00 AM, +0000 UTC",
        "snippet": null,
        "source": "NEJM"
      }
    ]
  },
  "total_results": 2
}

Search for articles across multiple news datasets in a single request.

Searches the same query across all specified datasets simultaneously with combined site: operators for efficient multi-source search.

Supported Datasets: nytimes, washpost, sfstandard, sacbee, sfchronicle, newyorker, theatlantic, sjmercury, latimes

Example:

POST /v2/datasets/batch-search
{
    "q": "artificial intelligence regulation",
    "datasets": ["nytimes", "washpost", "theatlantic"],
    "limit": 20
}

Headers:

Authorization: Bearer {api_key}
X-Organization-ID: Organization UUID

Request

This endpoint expects an object.

qstringRequired

Search query

authorstring or nullOptional

Filter results by author/byline name. Appended as quoted phrase to search query.

datasetslist of strings or nullOptional

List of dataset names to search across. Defaults to all datasets if not provided.

limitintegerOptional1-100Defaults to 10

Max results per dataset

Response

Successful Response

querystring

datasets_searchedlist of stringsOptional

errorsmap from strings to stringsOptional

resultslist of objectsOptional

results_by_datasetmap from strings to lists of objectsOptional

total_resultsintegerOptionalDefaults to 0

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

503

Service Unavailable Error