List Domains by Publication URL | AISquare Studio

import requests
url = "https://api.example.com/api/v1/qllm/domain/by-url/"
payload = { "url": "https://examplepublication.com/custom-article-123" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "domain_id": 42,
  "tags": [
    "AI",
    "Machine Learning",
    "Deep Learning"
  ],
  "created_by": {
    "id": 101,
    "username": "jatin_saini",
    "email": "jatin.saini@example.com",
    "first_time_login": false,
    "profile_picture": "https://cdn.example.com/profiles/jatin_saini.jpg",
    "full_name": "Jatin Saini",
    "theme": "light",
    "is_superuser": false,
    "is_staff": true,
    "is_active": true,
    "is_verified": true
  },
  "category": "Technology",
  "subcategory": "Artificial Intelligence",
  "co_creators": [
    {
      "id": 102,
      "username": "alice_wong",
      "email": "alice.wong@example.com",
      "first_time_login": false,
      "profile_picture": "https://cdn.example.com/profiles/alice_wong.png",
      "full_name": "Alice Wong",
      "theme": "dark",
      "is_superuser": false,
      "is_staff": false,
      "is_active": true,
      "is_verified": true
    }
  ],
  "saved": true,
  "metrics": "Users: 1500, Articles: 320",
  "workspace_id": 7,
  "publication": {},
  "name": "Artificial Intelligence Research",
  "theme": "dark",
  "summary": "A domain focused on the latest advancements in AI and machine learning.",
  "description": "This domain covers research papers, articles, and discussions related to artificial intelligence, including deep learning, neural networks, and AI ethics.",
  "logo": "https://cdn.example.com/logos/ai_research_logo.png",
  "cover": "https://cdn.example.com/covers/ai_research_cover.jpg",
  "focus_area": "Machine Learning Algorithms",
  "visibility": "public",
  "is_draft": false,
  "creation_status": "completed"
}

This endpoint accepts a POST request with a JSON body containing a ‘url’ parameter (the publication’s custom URL) and returns a paginated list of domains filtered based on the owner extracted from that publication. In addition, query parameters such as ‘id’, ‘tag’, ‘recommended’, ‘n’, search, and additional filters can be used for further filtering or random selection.

Query parameters

categorystringOptional

Filter domains by category name.

idstringOptional

Filter by domain UID.

most_popularstringOptional

Sort domains by popularity (number of users). Mutually exclusive with other sorting options.

most_recentstringOptional

Sort domains by creation date (most recent first). Mutually exclusive with other sorting options.

nintegerOptional

Limit the number of random domains returned.

recently_viewedstringOptional

Sort domains by last update date (most recently updated first). Mutually exclusive with other sorting options.

recommendedstringOptional

Flag to retrieve recommended domains.

savedstringOptional

Filter to show only saved domains (requires authentication).

searchstringOptional

Search across domain name, summary, description, and creator usernames.

subcategorystringOptional

Filter domains by subcategory name.

tagstringOptional

Filter domains by a specific tag.

Request

This endpoint expects an object.

urlstringRequired

Publication's custom URL.

Response

A paginated list of domains filtered by the Publication owner and additional filters.

idstringformat: "uuid"

domain_idintegerRead-only

tagslist of stringsRead-only

created_byobject

Mixin to handle profile_picture serialization for WebSocket compatibility.

This mixin adds a SerializerMethodField for profile_picture that converts ImageFieldFile objects to URL strings, making them JSON serializable for WebSocket consumers.

The mixin intelligently handles profile pictures from IAMUserDetail by:

Accessing the related details queryset on the IAMUser model
Extracting the ImageFieldFile from the first detail record
Converting it to a URL string for JSON serialization

Usage:

1 class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer):
2     class Meta:
3         model = User
4         fields = ['id', 'username', 'profile_picture', ...]

Note:

This mixin expects the model to have a details related manager
The related detail should have a profile_picture ImageField
Returns None if no profile picture is found or an error occurs

Mixin to handle profile_picture serialization for WebSocket compatibility. This mixin adds a SerializerMethodField for profile_picture that converts ImageFieldFile objects to URL strings, making them JSON serializable for WebSocket consumers. The mixin intelligently handles profile pictures from IAMUserDetail by: 1. Accessing the related `details` queryset on the IAMUser model 2. Extracting the ImageFieldFile from the first detail record 3. Converting it to a URL string for JSON serialization Usage: ```python class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer): class Meta: model = User fields = ['id', 'username', 'profile_picture', ...] ``` Note: - This mixin expects the model to have a `details` related manager - The related detail should have a `profile_picture` ImageField - Returns None if no profile picture is found or an error occurs

categorystring or nullRead-only

subcategorystring or nullRead-only

co_creatorslist of objects

savedbooleanRead-only

metricsstringRead-only

workspace_idintegerRead-only

publicationmap from strings to any or nullRead-only

namestring<=255 characters

themestring<=64 characters

summarystring or null<=1024 characters

descriptionstring or null

logostring or nullformat: "uri"

Logo image for the domain (copied from experience)

coverstring or nullformat: "uri"

Cover image for the domain (copied from experience)

focus_areastring or null<=256 characters

visibilityenum

public - Public
private - Private
team - Team
org - Organization

* `public` - Public * `private` - Private * `team` - Team * `org` - Organization

Allowed values:

is_draftboolean

creation_statusenum

not_started - Not Started
in_progress - In Progress
completed - Completed
failed - Failed

* `not_started` - Not Started * `in_progress` - In Progress * `completed` - Completed * `failed` - Failed

Allowed values:

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

Mixin to handle profile_picture serialization for WebSocket compatibility.

This mixin adds a SerializerMethodField for profile_picture that converts ImageFieldFile objects to URL strings, making them JSON serializable for WebSocket consumers.

The mixin intelligently handles profile pictures from IAMUserDetail by:

Accessing the related details queryset on the IAMUser model
Extracting the ImageFieldFile from the first detail record
Converting it to a URL string for JSON serialization

Usage:

1 class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer):
2     class Meta:
3         model = User
4         fields = ['id', 'username', 'profile_picture', ...]

Note:

This mixin expects the model to have a details related manager
The related detail should have a profile_picture ImageField
Returns None if no profile picture is found or an error occurs

1	class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer):
2	class Meta:
3	model = User
4	fields = ['id', 'username', 'profile_picture', ...]