Skip to content
Modrinth Documentation

Get a list of random projects

GET
/projects_random

Parameters

Query Parameters

count
required
integer
<= 100 
70

The number of random projects to return

Responses

200

Expected response to a valid request

Array
object
slug

The slug of a project, used for vanity URLs. Regex: ^[\w!@$()`.+,"\-']{3,64}$

string
my_project
title

The title or name of the project

string
My Project
description

A short description of the project

string
A short description
categories

A list of the categories that the project has

Array<string>
[
  "technology",
  "adventure",
  "fabric"
]
client_side

The client side support of the project

string
Allowed values: required optional unsupported unknown 
required
server_side

The server side support of the project

string
Allowed values: required optional unsupported unknown 
optional
body

A long form description of the project

string
A long body describing my project in detail
status

The status of the project

string
Allowed values: approved archived rejected draft unlisted processing withheld scheduled private unknown 
approved
requested_status

The requested status when submitting for review or scheduling the project for release

string
nullable
Allowed values: approved archived unlisted private draft
additional_categories

A list of categories which are searchable but non-primary

Array<string>
[
  "technology",
  "adventure",
  "fabric"
]
issues_url

An optional link to where to submit bugs or issues with the project

string
nullable 
https://github.com/my_user/my_project/issues
source_url

An optional link to the source code of the project

string
nullable 
https://github.com/my_user/my_project
wiki_url

An optional link to the project’s wiki page or other relevant information

string
nullable 
https://github.com/my_user/my_project/wiki
discord_url

An optional invite link to the project’s discord

string
nullable 
https://discord.gg/AaBbCcDd
donation_urls

A list of donation links for the project

Array<object>
object
id

The ID of the donation platform

string
patreon
platform

The donation platform this link is to

string
Patreon
url

The URL of the donation platform and user

string
https://www.patreon.com/my_user
slug

The slug of a project, used for vanity URLs. Regex: ^[\w!@$()`.+,"\-']{3,64}$

string
my_project
title

The title or name of the project

string
My Project
description

A short description of the project

string
A short description
categories

A list of the categories that the project has

Array<string>
[
  "technology",
  "adventure",
  "fabric"
]
client_side

The client side support of the project

string
Allowed values: required optional unsupported unknown 
required
server_side

The server side support of the project

string
Allowed values: required optional unsupported unknown 
optional
project_type
required

The project type of the project

string
Allowed values: mod modpack resourcepack shader 
mod
downloads
required

The total number of downloads of the project

integer
icon_url

The URL of the project’s icon

string
nullable 
https://cdn.modrinth.com/data/AABBCCDD/b46513nd83hb4792a9a0e1fn28fgi6090c1842639.png
color

The RGB color of the project, automatically generated from the project icon

integer
nullable 
8703084
thread_id

The ID of the moderation thread associated with this project

string
TTUUVVWW
monetization_status
string
Allowed values: monetized demonetized force-demonetized
id
required

The ID of the project, encoded as a base62 string

string
AABBCCDD
team
required

The ID of the team that has ownership of this project

string
MMNNOOPP
body_url

The link to the long description of the project. Always null, only kept for legacy compatibility.

string
nullable
moderator_message

A message that a moderator sent regarding the project

object
message

The message that a moderator has left for the project

string
body

The longer body of the message that a moderator has left for the project

string
nullable
published
required

The date the project was published

string format: ISO-8601
updated
required

The date the project was last updated

string format: ISO-8601
approved

The date the project’s status was set to an approved status

string format: ISO-8601
nullable
queued

The date the project’s status was submitted to moderators for review

string format: ISO-8601
nullable
followers
required

The total number of users following the project

integer
license

The license of the project

object
id

The SPDX license ID of a project

string
LGPL-3.0-or-later
name

The long name of a license

string
GNU Lesser General Public License v3 or later
url

The URL to this license

string
nullable
versions

A list of the version IDs of the project (will never be empty unless draft status)

Array<string>
[
  "IIJJKKLL",
  "QQRRSSTT"
]
game_versions

A list of all of the game versions supported by the project

Array<string>
[
  "1.19",
  "1.19.1",
  "1.19.2",
  "1.19.3"
]
loaders

A list of all of the loaders supported by the project

Array<string>
[
  "forge",
  "fabric",
  "quilt"
]
gallery

A list of images that have been uploaded to the project’s gallery

Array<object>
object
url
required

The URL of the gallery image

string
https://cdn.modrinth.com/data/AABBCCDD/images/009b7d8d6e8bf04968a29421117c59b3efe2351a.png
featured
required

Whether the image is featured in the gallery

boolean
true
title

The title of the gallery image

string
nullable 
My awesome screenshot!
description

The description of the gallery image

string
nullable 
This awesome screenshot shows all of the blocks in my mod!
created
required

The date and time the gallery image was created

string format: ISO-8601
ordering

The order of the gallery image. Gallery images are sorted by this field and then alphabetically by title.

integer
0

400

Request was invalid, see given error

object
error
required

The name of the error

string
invalid_input
description
required

The contents of the error

string
Error while parsing multipart payload