***

title: Working with creators
description: How to retrieve and work with creator and co-creator data in AISquare.
-----------------------------------------------------------------------------------

This guide explains how to retrieve and work with creator and co-creator data in AISquare.

***

## Overview

AISquare provides endpoints to access:

* **Creator profiles**
* **Co-creators of a publication**

These endpoints return user-related data associated with an AI Studio (publication).

***

## Creator profiles

This endpoint returns detailed profile information for:

* The publication creator (owner)
* All co-creators

### Endpoint

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

### Request body

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

### Access control

* Requires authentication
* Returns `404` if the publication is not found

### Response structure

**Publication**

* `id`
* `name`
* `custom_url`

**Creator**

Includes full profile details:

* `id`
* `username`
* `email`
* `full_name`
* `is_verified`
* `followers_count`
* `profile_picture`
* `bio`
* `country`

**Social links**

* `linkedin_url`
* `github_url`
* `twitter_url`
* `facebook_url`
* `website_url`
* `portfolio_url`

**Skills and focus**

* `skills` (array)
* `focus_area` (array)

**Co-creators**

Each co-creator includes:

* `id`
* `username`
* `email`
* `full_name`
* `is_verified`
* `followers_count`
* `profile_picture`
* `bio`
* `country`
* Social links
* `skills`
* `focus_area`
* `role`
* `status`

***

## Co-creators (minimal data)

This endpoint returns a list of co-creators with minimal user details.

### Endpoint

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

### Request body

```json
{
  "publication_url": "example-publication"
}
```

### Query parameters

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

### Access control

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

### Response includes

For each co-creator:

* `uid`
* `user`:
  * `id`
  * `username`
  * `full_name`
  * `profile_picture`
* `role`
* `status`
* `created_at`

***

## Data differences between endpoints

| Endpoint           | Data returned                      |
| ------------------ | ---------------------------------- |
| `creator-profiles` | Full creator + co-creator profiles |
| `co-creators`      | Minimal co-creator list            |

> **Note:** `creator-profiles` uses `url` in request body. `co-creators` uses `publication_url` in request body. Both endpoints return data scoped to a publication.

***

## When to use each endpoint

| Use case               | Endpoint           |
| ---------------------- | ------------------ |
| Detailed profile pages | `creator-profiles` |
| Listing collaborators  | `co-creators`      |

***

## Error responses

| Status | Meaning                            |
| ------ | ---------------------------------- |
| `400`  | Missing or invalid publication URL |
| `404`  | Publication not found              |

***

## Related pages

* [AI Studios](/docs/product/ai-studios) — publication-scoped data
* [Core Concepts](/docs/getting-started/core-concepts) — creator and co-creator roles
* [Metrics and analytics](/docs/insights/metrics-and-analytics) — owner/co-creator metrics
* [Permissions and access control](/docs/data-ux-guides/permissions-and-access-control) — roles and access levels
* [Authentication](/docs/getting-started/authentication) — required for all endpoints
* [Errors](/docs/reference/errors) — handle error responses