Get Quest Suggestions | AISquare Studio

curl /api/v1/quests/suggestions/ \
     -H "Content-Type: application/json"

{
  "count": 123,
  "results": [
    {
      "id": 42,
      "uid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "name": "Introduction to Machine Learning",
      "player_level": {
        "id": 2,
        "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Beginner",
        "description": "Suitable for users new to the topic",
        "avg_score": 75
      },
      "metrics": "views:1500, completions:300, avg_score:78",
      "created_by": {
        "id": 100,
        "username": "quest_creator",
        "email": "creator@aisquare.com",
        "full_name": "John Smith",
        "is_verified": true,
        "details": [
          {
            "profile_picture": "https://aisquare.com/profiles/john.jpg",
            "bio": "Content creator and AI enthusiast",
            "country": "Canada",
            "phone": "+1-555-987-6543",
            "linkedin_url": "https://linkedin.com/in/johnsmith",
            "github_url": "https://github.com/johnsmith",
            "twitter_url": "https://twitter.com/john_ai",
            "website_url": "https://johnsmith.ai",
            "top_domain_elo": 2300,
            "top_domain_rank": 25
          }
        ],
        "followers_count": 4200
      },
      "created_at": "2024-01-15T09:30:00Z",
      "publication_url": "https://aisquare.com/publications/ml-intro",
      "publication": {
        "publisher": "AISquare Publishing",
        "year": 2024,
        "doi": "10.1234/aisquare.ml.2024"
      },
      "user_added_quest": true,
      "updated_at": "2024-04-10T12:00:00Z",
      "workspace_id": 7,
      "urls": [
        "https://aisquare.com/quests/ml-intro"
      ],
      "files": [
        "https://aisquare.com/resources/ml-intro-guide.pdf"
      ],
      "logo": "https://aisquare.com/assets/logos/ml-quest-logo.png",
      "cover": "https://aisquare.com/assets/covers/ml-quest-cover.jpg",
      "tags": [
        "machine learning",
        "data science",
        "beginner"
      ],
      "category": "Technology",
      "subcategory": "Artificial Intelligence",
      "focus_area": "Supervised Learning",
      "recommended_skills": [
        "Python",
        "Statistics",
        "Linear Algebra"
      ],
      "visibility": "public",
      "summary": "A beginner-friendly quest to get started with machine learning concepts and applications.",
      "description": "This quest covers the basics of machine learning, including algorithms, data preparation, and model evaluation.",
      "co_creators": [
        {
          "id": 101,
          "username": "ai_expert",
          "email": "ai.expert@aisquare.com",
          "full_name": "Alice Johnson",
          "is_verified": true,
          "details": [
            {
              "profile_picture": "https://aisquare.com/profiles/alice.jpg",
              "bio": "AI researcher and educator",
              "country": "USA",
              "phone": "+1-555-123-4567",
              "linkedin_url": "https://linkedin.com/in/alicejohnson",
              "github_url": "https://github.com/alicejohnson",
              "twitter_url": "https://twitter.com/ai_alice",
              "website_url": "https://alicejohnson.ai",
              "top_domain_elo": 2450.5,
              "top_domain_rank": 12
            }
          ],
          "followers_count": 3500
        }
      ],
      "creation_status": "not_started"
    }
  ],
  "next": "http://api.aisquare.com/quests/suggestions/?page=4",
  "previous": "http://api.aisquare.com/quests/suggestions/?page=2"
}

Retrieves suggested quests for the authenticated user. If quest_id is provided, returns quests similar to the specified quest based on matching attributes (category, subcategory, tags, player_level, focus_area). If quest_id is not provided, returns general public quests excluding those the user has already started.

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

quest_idintegerOptional

Optional. The ID of a quest to find similar quests for.

Response

List of suggested quests

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

Errors

401

Unauthorized Error