Working with creators

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

1
{
2
  "url": "ai-research-studio"
3
}

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

1
{
2
  "publication_url": "example-publication"
3
}

Query parameters

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

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

Error responses

Related pages

• AI Studios — publication-scoped data
• Core Concepts — creator and co-creator roles
• Metrics and analytics — owner/co-creator metrics
• Permissions and access control — roles and access levels
• Authentication — required for all endpoints
• Errors — handle error responses