***

title: AI Studios
description: How to work with AI Studio-related APIs in AISquare.
-----------------------------------------------------------------

This guide explains how to work with AI Studio-related APIs in AISquare.

***

## Overview

AI Studio endpoints provide access to:

* Publication-level data
* Experiences and resources
* Creators and collaborators
* Engagement and metrics
* User-specific data

All endpoints are scoped to a publication, identified by a unique URL.

***

## Working with a publication

Most AI Studio endpoints require a publication identifier.

### Request body

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

### Notes

* `url` refers to the publication custom URL
* Required for most POST-based endpoints
* Used to scope results to a specific AI Studio

***

## Experience resources (flattened)

Retrieve experience resources in a flattened format.

### Endpoint

```
POST /api/v1/aistudios/experiences/flattened/
```

### Query parameters

| Parameter       | Description                     |
| --------------- | ------------------------------- |
| `category`      | Filter by category ID           |
| `category_name` | Filter by category name         |
| `search`        | Search content                  |
| `type`          | `AI_EXPERT`, `AI_NOTE`, `QUEST` |
| `ordering`      | Sorting                         |
| `page`          | Page number                     |
| `page_size`     | Results per page                |

### Response

* Paginated list of resources
* Each item represents one resource
* Includes experience, resource, creator, and metrics data

***

## Community pulse

Retrieve trending resources for a publication.

### Endpoint

```
POST /api/v1/aistudios/community-pulse/
```

### Query parameters

| Parameter | Description                             |
| --------- | --------------------------------------- |
| `limit`   | Number of resources (default 5, max 10) |

### Response

* List of trending resources
* Includes pulse descriptions for each item

***

## Continue where left off

Retrieve recently viewed resources for the user.

### Endpoint

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

### Query parameters

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

### Response

* Paginated list of recently viewed resources
* Includes experience, resource, and interaction details

***

## Creator profiles

Retrieve detailed creator and co-creator profiles.

### Endpoint

```
POST /api/v1/aistudios/creator-profiles/
```

### Response

* Publication details
* Creator profile
* Co-creator profiles

***

## Co-creators

Retrieve co-creators with minimal user details.

### Endpoint

```
POST /api/v1/aistudios/co-creators/
```

### Query parameters

| Parameter   | Description                |
| ----------- | -------------------------- |
| `search`    | Search by username or name |
| `page`      | Page number                |
| `page_size` | Results per page           |

***

## Popular tags

Retrieve tags ranked by content usage.

### Endpoint

```
POST /api/v1/aistudios/popular-tags/
```

### Query parameters

| Parameter   | Description      |
| ----------- | ---------------- |
| `search`    | Search tags      |
| `page`      | Page number      |
| `page_size` | Results per page |

### Response

* Paginated list of tags
* Includes `content_count`

***

## Professional history

Retrieve work experience history for a user.

### Endpoint

```
POST /api/v1/aistudios/professional-history/{username}/
```

### Path parameters

| Parameter  | Description     |
| ---------- | --------------- |
| `username` | User identifier |

### Response

* List of work experiences
* Includes role, company, dates, and description

***

## Expertise focus

Retrieve distribution of experience categories for a user.

### Endpoint

```
POST /api/v1/aistudios/expertise-focus/{username}/
```

### Path parameters

| Parameter  | Description     |
| ---------- | --------------- |
| `username` | User identifier |

### Response

* Category names with counts

***

## Metrics

Retrieve analytics for a publication.

### Owner metrics

```
POST /api/v1/aistudios/metrics/
```

* Restricted to owner or co-creator

### Public impact

```
POST /api/v1/aistudios/public-impact/
```

* Available to authenticated users

***

## Permissions

Validate access to a publication.

### Endpoint

```
POST /api/v1/aistudios/permission/
```

### Behavior

* Validates access
* May set workspace context
* Returns status based on access

***

## Notes

* Most endpoints require [authentication](/docs/getting-started/authentication)
* Most endpoints require `url` in request body
* Responses are typically [paginated](/docs/data-ux-guides/search-filtering-and-pagination)
* Data is scoped to a publication

***

## Related pages

* [Core Concepts](/docs/getting-started/core-concepts) — understand entities and hierarchy
* [Content modeling guide](/docs/data-ux-guides/content-modeling-guide) — structure resources for your UI
* [Working with creators](/docs/insights/working-with-creators) — detailed creator profile endpoints
* [Metrics and analytics](/docs/insights/metrics-and-analytics) — engagement and impact metrics
* [Permissions and access control](/docs/data-ux-guides/permissions-and-access-control) — publication access validation
* [Activity and personalization](/docs/product/activity-and-personalization) — continue-where-left-off details
* [Collections](/docs/product/collections) — organize experiences into groups
* [Community](/docs/product/community) — community pulse and discovery