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

# Get User Request Count Timeframe

> Return hourly API request counts for a user over a timestamp window.

## Request

<ParamField path="user_id" type="string" required>
  User ID to inspect.
</ParamField>

<ParamField query="start_time" type="integer" required>
  Inclusive start timestamp in Unix milliseconds.
</ParamField>

<ParamField query="end_time" type="integer" required>
  Inclusive end timestamp in Unix milliseconds.
</ParamField>

## Response

<ResponseField name="requests_per_timestamp" type="array">
  Hourly buckets with `timestamp` and `count`.
</ResponseField>

## Example

<CodeGroup>
  ```python Python SDK theme={null}
  from entityml import EntityMLClient

  client = EntityMLClient()
  counts = client.analytics.get_user_request_count_timeframe(
      user_id="YOUR_USER_ID",
      start_time=1775000000000,
      end_time=1775086400000,
  )
  print(counts["total_requests"])
  ```

  ```bash CLI theme={null}
  entityml analytics user-request-count-timeframe \
    --user-id YOUR_USER_ID \
    --start-time 1775000000000 \
    --end-time 1775086400000
  ```

  ```bash Raw HTTP (cURL) theme={null}
  curl "https://api.entityml.com/api/v1/user/YOUR_USER_ID/requests/count/timeframe?start_time=1775000000000&end_time=1775086400000"
  ```
</CodeGroup>

### Example response

```json theme={null}
{
  "user_id": "YOUR_USER_ID",
  "start_time": 1775000000000,
  "end_time": 1775086400000,
  "requests_per_timestamp": [
    { "timestamp": "2026-04-01T12:00:00+00:00", "count": 42 }
  ],
  "total_requests": 42,
  "skipped_rows": 0
}
```