> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ACTIVITY

> Cross-platform respondent activity statistics for identifying professional survey takers.

ACTIVITY reports how often a respondent (identified by token) has been seen across the Research Defender ecosystem in a time window. It is hosted on `https://prod.resdefio.com` and authenticates with an `x-api-key` header.

## Core Functionality

* Cross-platform respondent activity tracking
* Statistical analysis of survey participation patterns
* Professional survey taker identification through behavioral metrics
* Ecosystem-wide intelligence spanning multiple research platforms
* Configurable time-range analysis (1, 3, 8, 12, 24, 168, or 730 hours)
* Advanced statistical modeling including averages, medians, and standard deviations

## Key Features

* **Ecosystem Intelligence:** Leverages data from millions of respondents across multiple platforms
* **Statistical Analysis:** Provides count, average, ratio, median, and standard deviation metrics
* **Configurable Time Windows:** Allows analysis across different time periods
* **Professional Detection:** Identifies respondents with abnormally high survey participation
* **Cross-Platform Tracking:** Monitors activity across different research environments
* **Real-Time Analysis:** Provides immediate insights into respondent behavior patterns

## Statistical Metrics Provided

* **Count:** Total number of surveys attempted by respondent in specified timeframe
* **Average:** Mean survey participation rate within the ecosystem
* **Ratio:** Proportion of devices linked to the respondent's digital fingerprint
* **Median:** Middle value of all session occurrences for the respondent
* **Standard Deviation:** Variability measure of respondent's survey participation

## Integration Options

* Client-side integration for direct browser-based calls
* Server-to-server integration (recommended) for enhanced security
* Token-based authentication through the [GETTOKEN (new stack)](/research-defender/endpoints/get-token) API

<CardGroup cols={2}>
  <Card title="Activity Integration" icon="code" href="/research-defender/guides/activity/02-integration">Send a POST request with your `x-api-key`, with a full HTML sample.</Card>
</CardGroup>

## Typical Use Cases

* Professional survey taker identification
* Survey quality assurance and data cleaning
* Panel management and respondent qualification
* Academic research integrity verification
* Market research data validation

## Response Results

The response has a `Statistics` node, with `Activity` and then `Token` inside it. `Token` holds these fields:

| Field | Description |
| - | - |
| `Count` | The number of surveys attempted by the corresponding token in the Research Defender ecosystem during the given time frame. |
| `Average` | The average number of occurrences of sessions per the corresponding token in the Research Defender ecosystem during the specified range. |
| `Ratio` | The ratio of devices seen across the ecosystem that are linked to a given respondent's digital fingerprint or IP address during the specified range. |
| `Median` | The median of all Research Defender sessions per the corresponding token during the specified range. |
| `StandardDeviation` | The standard deviation of all Research Defender digital fingerprints found across the industry within the specific time frame. |
| `ClientOverlap` | The number of unique clients associated with the respondent during the specified range. |

```json theme={null}
{
  "Statistics": [
    {
      "Activity": {
        "Token": {
          "Count": 67,
          "Average": 7.10464756,
          "Ratio": 2,
          "Median": 2,
          "StandardDeviation": 34.66883612345676,
          "ClientOverlap": 2
        }
      }
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.