Name: Spillover Risk API: Hantavirus Data, Outbreaks & Ecology
Brand: nicheapi-llc-1
SKU: api-nicheapi-llc-1-spilloverrisk
Availability: InStock
Author: API Market

True Scary Stories

# Spillover Risk API

## Overview

The Spillover Risk API is a scientific reference database for zoonotic spillover risk assessment, with a focus on hantaviruses. It organizes the subject across three dimensions: **where** spillover could happen (ecological zones with quantified environmental risk factors), **when** it has happened (historical outbreak events documented since 1993), and **which species** carry it (reservoir rodents with confirmed virus associations and standardized risk ratings). Designed for developers, epidemiologists, public health agencies, and researchers, the API delivers structured, machine-readable access to data that has historically been scattered across academic literature, WHO situation reports, and national surveillance systems.

## Features

*   **3 Dedicated Endpoints**: Access three distinct scientific data categories — ecological risk zones, historical outbreak events, and hantavirus reservoir species.
*   **Full-Text Search**: Filter records by keyword across all fields using the `?q=` query parameter.
*   **Pagination Support**: Efficiently retrieve large datasets with `?limit=` and `?offset=` parameters.
*   **Detailed Lookup**: Fetch individual records directly by unique ID, or outbreak records by year.
*   **Authoritative Data**: All records are curated from primary scientific and public health sources — including CDC, WHO, PubMed-indexed outbreak reports, and established rodent-virus association literature — not auto-generated.
*   **High Availability**: A rate limit of 60 requests per minute across all plans.

## Use Cases

*   **Epidemiological Surveillance Platforms**: Public health agencies and academic institutions can integrate real-time ecological zone and outbreak history data into surveillance dashboards to monitor hantavirus activity, flag high-risk periods, and support early warning systems.
*   **Field Research & Expedition Planning**: Researchers and NGOs planning fieldwork in rodent-rich or historically affected regions can query ecological zones and reservoir species data to assess site-specific spillover risk before deployment.
*   **One Health & Zoonotic Disease Modeling**: Computational biologists building predictive spillover models can use the API to pull structured inputs across all three risk dimensions — environment, host species, and outbreak history — into disease transmission frameworks.
*   **Clinical Decision Support**: Healthcare providers and health information systems in endemic regions can surface hantavirus strain, reservoir, and geographic context data to assist with differential diagnosis when patients present with hantavirus pulmonary syndrome (HPS) or hemorrhagic fever with renal syndrome (HFRS) symptoms.
*   **Environmental & Climate Research**: Scientists studying the relationship between land use change, climate variability, and zoonotic risk can cross-reference ecological zone risk factors with historical outbreak chronologies to identify environmental drivers of spillover events.


## API Documentation

### Base URL

All API requests for the Spillover Risk API should be made to the following base URL:

```
'https://prod.api.market/api/v1/nicheapi-llc-1/spilloverrisk'
```

### Authentication

Authentication is handled via an API key. You must include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

Replace `YOUR_API_MARKET_KEY` with your actual API key obtained from API.market.


### Endpoints

#### 1. List Ecological Zones

Retrieve a paginated list of ecological zones with associated hantavirus spillover risk factors and classifications.

**Method**: `GET`
**Endpoint**: `/spilloverrisk/ecological_zones`

**Parameters**:

| Name     | In    | Description                                            | Type      | Required | Default | Max Value |
| :------- | :---- | :----------------------------------------------------- | :-------- | :------- | :------ | :-------- |
| `q`      | query | Search query to filter ecological zones by keyword     | `string`  | No       |         |           |
| `limit`  | query | Maximum number of results per page                     | `integer` | No       | `50`    | `1000`    |
| `offset` | query | Number of results to skip for pagination               | `integer` | No       | `0`     |           |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/spilloverrisk/spilloverrisk/ecological_zones?q=Andes&limit=2" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK)**:

```json
[
  {
    "id": "eco_zone_1",
    "zone_name": "Southern Andes Temperate Forest",
    "region": "South America",
    "countries": ["Argentina", "Chile"],
    "climate_type": "Temperate Oceanic",
    "vegetation_type": "Valdivian Temperate Rainforest",
    "primary_hantavirus": "Andes orthohantavirus",
    "risk_level": "High",
    "environmental_risk_factors": "Mast seeding events (lenga beech), high rodent density cycles, peridomestic rodent incursion",
    "area_km2": 248000,
    "notes": "Only hantavirus with confirmed person-to-person transmission documented."
  },
  {
    "id": "eco_zone_2",
    "zone_name": "Patagonian Steppe",
    "region": "South America",
    "countries": ["Argentina"],
    "climate_type": "Semi-Arid Cold Steppe",
    "vegetation_type": "Shrubland and Grassland",
    "primary_hantavirus": "Andes orthohantavirus",
    "risk_level": "Medium",
    "environmental_risk_factors": "Seasonal rodent population booms, agricultural encroachment, reduced predator populations",
    "area_km2": 670000,
    "notes": "Risk elevation correlates with La Niña-driven precipitation anomalies."
  }
]
```

---

#### 2. Get Ecological Zone by ID

Retrieve a single ecological zone record by its unique identifier.

**Method**: `GET`
**Endpoint**: `/spilloverrisk/ecological_zones/{id}`

**Parameters**:

| Name | In   | Description                               | Type     | Required |
| :--- | :--- | :---------------------------------------- | :------- | :------- |
| `id` | path | Unique identifier for the ecological zone | `string` | Yes      |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/spilloverrisk/spilloverrisk/ecological_zones/eco_zone_1" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK)**:

```json
{
  "id": "eco_zone_1",
  "zone_name": "Southern Andes Temperate Forest",
  "region": "South America",
  "countries": ["Argentina", "Chile"],
  "climate_type": "Temperate Oceanic",
  "vegetation_type": "Valdivian Temperate Rainforest",
  "primary_hantavirus": "Andes orthohantavirus",
  "risk_level": "High",
  "environmental_risk_factors": "Mast seeding events (lenga beech), high rodent density cycles, peridomestic rodent incursion",
  "area_km2": 248000,
  "notes": "Only hantavirus with confirmed person-to-person transmission documented."
}
```

---

#### 3. List Outbreak History

Retrieve a paginated list of documented hantavirus outbreak events since 1993, with epidemiological details.

**Method**: `GET`
**Endpoint**: `/spilloverrisk/outbreak_history`

**Parameters**:

| Name     | In    | Description                                              | Type      | Required | Default | Max Value |
| :------- | :---- | :------------------------------------------------------- | :-------- | :------- | :------ | :-------- |
| `q`      | query | Search query to filter outbreak records by keyword       | `string`  | No       |         |           |
| `limit`  | query | Maximum number of results per page                       | `integer` | No       | `50`    | `1000`    |
| `offset` | query | Number of results to skip for pagination                 | `integer` | No       | `0`     |           |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/spilloverrisk/spilloverrisk/outbreak_history?q=Sin+Nombre&limit=1" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK)**:

```json
[
  {
    "year": 1993,
    "location": "Four Corners Region",
    "country": "USA",
    "state_province": "New Mexico, Arizona, Colorado, Utah",
    "hantavirus_strain": "Sin Nombre orthohantavirus",
    "syndrome": "Hantavirus Pulmonary Syndrome (HPS)",
    "confirmed_cases": 24,
    "deaths": 13,
    "case_fatality_rate_pct": 54.2,
    "primary_reservoir": "Peromyscus maniculatus (Deer Mouse)",
    "transmission_setting": "Rural/Peridomestic",
    "outbreak_context": "Index cluster; led to formal characterization of HPS as a clinical syndrome",
    "source_reference": "CDC MMWR 1993; 42(22)"
  }
]
```

---

#### 4. Get Outbreak History by Year

Retrieve all documented hantavirus outbreak records for a specific year.

**Method**: `GET`
**Endpoint**: `/spilloverrisk/outbreak_history/{year}`

**Parameters**:

| Name   | In   | Description                                     | Type      | Required |
| :----- | :--- | :---------------------------------------------- | :-------- | :------- |
| `year` | path | Four-digit year of the outbreak event (≥ 1993)  | `integer` | Yes      |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/spilloverrisk/spilloverrisk/outbreak_history/1993" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK)**:

```json
{
  "year": 1993,
  "location": "Four Corners Region",
  "country": "USA",
  "state_province": "New Mexico, Arizona, Colorado, Utah",
  "hantavirus_strain": "Sin Nombre orthohantavirus",
  "syndrome": "Hantavirus Pulmonary Syndrome (HPS)",
  "confirmed_cases": 24,
  "deaths": 13,
  "case_fatality_rate_pct": 54.2,
  "primary_reservoir": "Peromyscus maniculatus (Deer Mouse)",
  "transmission_setting": "Rural/Peridomestic",
  "outbreak_context": "Index cluster; led to formal characterization of HPS as a clinical syndrome",
  "source_reference": "CDC MMWR 1993; 42(22)"
}
```

---

#### 5. List Reservoir Species

Retrieve a paginated list of rodent reservoir species with confirmed hantavirus associations and standardized risk ratings.

**Method**: `GET`
**Endpoint**: `/spilloverrisk/reservoir_species`

**Parameters**:

| Name     | In    | Description                                              | Type      | Required | Default | Max Value |
| :------- | :---- | :------------------------------------------------------- | :-------- | :------- | :------ | :-------- |
| `q`      | query | Search query to filter reservoir species by keyword      | `string`  | No       |         |           |
| `limit`  | query | Maximum number of results per page                       | `integer` | No       | `50`    | `1000`    |
| `offset` | query | Number of results to skip for pagination                 | `integer` | No       | `0`     |           |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/spilloverrisk/spilloverrisk/reservoir_species?q=Peromyscus&limit=1" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK)**:

```json
[
  {
    "id": "species_1",
    "common_name": "Deer Mouse",
    "scientific_name": "Peromyscus maniculatus",
    "family": "Cricetidae",
    "geographic_range": "North America (widespread)",
    "associated_hantavirus": "Sin Nombre orthohantavirus",
    "risk_rating": "High",
    "habitat": "Grasslands, forests, shrublands, agricultural margins",
    "primary_shedding_routes": ["Urine", "Feces", "Saliva"],
    "infection_prevalence_pct": 14.0,
    "notes": "Primary reservoir and transmission vector for HPS in the United States. Infection does not cause apparent disease in the host."
  }
]
```

---

#### 6. Get Reservoir Species by ID

Retrieve a single reservoir species record by its unique identifier.

**Method**: `GET`
**Endpoint**: `/spilloverrisk/reservoir_species/{id}`

**Parameters**:

| Name | In   | Description                                | Type     | Required |
| :--- | :--- | :----------------------------------------- | :------- | :------- |
| `id` | path | Unique identifier for the reservoir species | `string` | Yes      |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/spilloverrisk/spilloverrisk/reservoir_species/species_1" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK)**:

```json
{
  "id": "species_1",
  "common_name": "Deer Mouse",
  "scientific_name": "Peromyscus maniculatus",
  "family": "Cricetidae",
  "geographic_range": "North America (widespread)",
  "associated_hantavirus": "Sin Nombre orthohantavirus",
  "risk_rating": "High",
  "habitat": "Grasslands, forests, shrublands, agricultural margins",
  "primary_shedding_routes": ["Urine", "Feces", "Saliva"],
  "infection_prevalence_pct": 14.0,
  "notes": "Primary reservoir and transmission vector for HPS in the United States. Infection does not cause apparent disease in the host."
}
```

---

## Status Codes

| Code  | Status                | Description |
| :---- | :-------------------- | :---------- |
| `200` | OK                    | The request succeeded and data has been returned. |
| `400` | Bad Request           | The request contains invalid parameters or a malformed query. Review your request syntax. |
| `401` | Unauthorized          | The `x-api-market-key` header is missing or contains an invalid key. |
| `403` | Forbidden             | Your API key is valid but lacks permission to access this resource. |
| `404` | Not Found             | The requested endpoint, record ID, or year does not exist. Verify the URL path and identifier. |
| `429` | Too Many Requests     | You have exceeded the rate limit of 60 requests per minute. See the Rate Limits section. |
| `500` | Internal Server Error | An unexpected server-side error occurred. Retry the request after a brief delay. |
| `503` | Service Unavailable   | The server is temporarily unavailable due to maintenance or high load. Retry after a short delay. |

---

## Rate Limits

The Spillover Risk API enforces a limit of **60 requests per minute** across all plans. If exceeded, the API returns a `429 Too Many Requests` response. To handle this gracefully, implement client-side throttling and exponential backoff in your application. Where provided, the `Retry-After` header in the 429 response will indicate how long to wait before retrying.

---

## FAQ

*   **What disease focus does this API cover?**
    The API is specifically focused on hantaviruses — a family of RNA viruses transmitted primarily through contact with infected rodent urine, feces, or saliva. It covers both Hantavirus Pulmonary Syndrome (HPS), prevalent in the Americas, and Hemorrhagic Fever with Renal Syndrome (HFRS), prevalent in Europe and Asia.

*   **Why does the outbreak history start at 1993?**
    1993 marks the index cluster of HPS cases in the U.S. Four Corners region that led to the formal identification and characterization of hantavirus pulmonary syndrome as a clinical entity. The dataset uses this as its baseline year for consistent global outbreak comparison.

*   **What does `risk_rating` mean on reservoir species records?**
    Risk ratings (High / Medium / Low) reflect a composite assessment of the species' infection prevalence in wild populations, geographic overlap with human settlements, and the virulence of the associated hantavirus strain, drawn from peer-reviewed seroprevalence studies.

*   **Can I look up outbreaks for a specific year?**
    Yes — use the `/spilloverrisk/outbreak_history/{year}` endpoint with a four-digit year (1993 or later). For broader queries or keyword filtering, use the list endpoint with the `?q=` parameter (e.g., `?q=Chile` or `?q=HFRS`).

*   **Does the API cover hantavirus strains beyond Sin Nombre?**
    Yes. The dataset includes strains associated with outbreaks globally, including Andes, Puumala, Hantaan, Seoul, Dobrava, and others, wherever outbreak or reservoir data exists in the source literature.

*   **How do I authenticate?**
    Include your API key in the `x-api-market-key` request header on every call. See the Authentication section above for details.

*   **What is the rate limit?**
    60 requests per minute across all plans. Exceeding this returns a `429` response.

---

## Contact

For questions or support, please reach out via the chat on the bottom right of the page or email **21truescarystories@gmail.com**.

Access the Spillover Risk API for structured data on hantavirus ecological zones, historical outbreaks, and reservoir species. Empower zoonotic risk assessment 