***

title: Community
description: >-
How to use community-related APIs in AISquare for contributors, events, and
discovery.
----------

This guide explains how to use community-related APIs in AISquare.

These endpoints provide access to:

* Contributors
* Events
* Public experience discovery

***

## Overview

Community APIs allow you to:

* Retrieve top contributors
* List upcoming events
* Explore public AI experiences

All endpoints return publicly relevant or community-scoped data.

***

## Top contributors

Retrieve the top contributors based on recent activity.

### Endpoint

```
GET /api/v1/community/contributors/top-week/
```

### Description

* Returns contributors from the last 7 days
* Based on activities such as:
  * Experience published
  * Publication created

### Query parameters

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

### Response includes

For each contributor:

* `id`
* `username`
* `full_name`
* `profile_picture`
* `activity` (summary of contributions)

### Access control

* Requires authentication

***

## Upcoming events

Retrieve upcoming community events.

### Endpoint

```
GET /api/v1/community/events/upcoming/
```

### Query parameters

| Parameter    | Description                                                          |
| ------------ | -------------------------------------------------------------------- |
| `event_type` | `challenge`, `contest`, `masterclass`, `panel`, `summit`, `workshop` |
| `search`     | Search across event name and description                             |
| `ordering`   | Sorting                                                              |
| `page`       | Page number                                                          |
| `page_size`  | Results per page                                                     |

### Response includes

* `event_name`
* `event_description`
* `event_type`
* `event_start_date`
* `event_end_date`
* `event_logo`
* `event_banner`
* `event_website`
* `event_prize`
* `created_at`
* `updated_at`

### Access control

* Requires authentication

***

## Explore experiences

Retrieve public AI experiences for discovery.

### Endpoint

```
GET /api/v1/community/explore/experiences/
```

### Description

* Returns public AI experiences
* Supports filtering and sorting

### Query parameters

| Parameter          | Description                     |
| ------------------ | ------------------------------- |
| `search`           | Free text search                |
| `category`         | Filter by category ID           |
| `category_name`    | Filter by category name         |
| `subcategory`      | Filter by subcategory ID        |
| `subcategory_name` | Filter by subcategory name      |
| `type`             | `AI_EXPERT`, `AI_NOTE`, `QUEST` |
| `tag`              | Filter by single tag            |
| `tags`             | Filter by multiple tags         |
| `ordering`         | Sorting                         |
| `page`             | Page number                     |
| `page_size`        | Results per page                |

### Sorting options

* `trending` (default)
* `newest`
* `popular`
* `updated`

### Response

* Paginated list of experiences
* Includes experience metadata and engagement data

### Access control

* Requires authentication

***

## Notes

* All endpoints support pagination
* Filtering and search are available across endpoints
* Responses are structured for listing and discovery use cases

***

## Summary

Community APIs provide access to:

* Contributor activity
* Upcoming events
* Discoverable AI experiences

***

## Related pages

* [AI Studios](/docs/product/ai-studios) — publication-scoped experience data
* [Core Concepts](/docs/getting-started/core-concepts) — resource types and entities
* [Working with creators](/docs/insights/working-with-creators) — contributor profiles
* [Search, filtering, and pagination](/docs/data-ux-guides/search-filtering-and-pagination) — filter and sort results
* [Authentication](/docs/getting-started/authentication) — required for all endpoints