***

title: Activity and personalization
description: >-
How to retrieve user activity and recently interacted content using AISquare
APIs.
-----

This guide explains how to retrieve user activity and recently interacted content using AISquare APIs.

***

## Overview

AISquare provides endpoints to:

* Retrieve user activity
* Fetch recently viewed resources

These endpoints return data specific to the authenticated user.

***

## User activity

This endpoint returns a list of activities associated with the authenticated user.

### Endpoint

```
GET /api/v1/activity/
```

### Query parameters

| Parameter   | Description      |
| ----------- | ---------------- |
| `page`      | Page number      |
| `page_size` | Results per page |

### Access control

* Requires authentication
* Returns `401` if user is not authenticated

### Response

* Paginated list of user activities
* Each item represents an activity record

***

## Retrieve a specific activity

### Endpoint

```
GET /api/v1/activity/{id}/
```

### Path parameters

| Parameter | Description |
| --------- | ----------- |
| `id`      | Activity ID |

### Access control

* Requires authentication
* Returns `404` if activity is not found

***

## Continue where you left off

This endpoint returns recently viewed resources for the user.

### Endpoint

```
POST /api/v1/aistudios/continue-where-left-off/
```

### Request body

```json
{
  "url": "ai-research-studio"
}
```

### Query parameters

| Parameter   | Description                                       |
| ----------- | ------------------------------------------------- |
| `limit`     | Number of resources to return (default 5, max 10) |
| `page`      | Page number                                       |
| `page_size` | Results per page                                  |

### Access control

* Requires authentication
* Returns `400` if `url` is missing or invalid
* Returns `404` if publication is not found

### Response includes

Each item represents a recently viewed resource with:

* `experience_id`
* `experience_uid`
* `experience_title`
* `experience_description`
* `resource_type`
* `resource_id`
* `resource_uid`
* `resource_title`
* `cover_image`

**Publication data**

* `publication_id`
* `publication_title`
* `publication_logo`
* `publication_custom_url`

**Metrics**

* `views`
* `likes`
* `shares`
* `bookmarks`

**Creator**

* `id`
* `username`
* `full_name`
* `profile_picture`

**Additional fields**

* `tags`
* `trending_score`
* `last_activity`
* `created_at`
* `updated_at`

***

## Notes

* Results are scoped to the authenticated user
* Returns recently viewed resources only
* Uses a flattened response structure

***

## Error responses

| Status | Meaning                  |
| ------ | ------------------------ |
| `400`  | Missing or invalid `url` |
| `401`  | Authentication required  |
| `404`  | Publication not found    |

***

## When to use these endpoints

| Use case            | Endpoint                  |
| ------------------- | ------------------------- |
| Activity history    | `/activity/`              |
| Resume user content | `continue-where-left-off` |

***

## Related pages

* [AI Studios](/docs/product/ai-studios) — continue-where-left-off is an AI Studio endpoint
* [Authentication](/docs/getting-started/authentication) — required for all activity endpoints
* [Core Concepts](/docs/getting-started/core-concepts) — activity in the entity hierarchy
* [User onboarding](/docs/integration-guides/user-onboarding-account-lifecycle) — personalization through per-user accounts
* [Metrics and analytics](/docs/insights/metrics-and-analytics) — related engagement data
* [Errors](/docs/reference/errors) — handle 400, 401, 404 responses