Skip to content
This repository was archived by the owner on Aug 28, 2025. It is now read-only.

MC-Marketplace-Bot/Minecraft.net-Marketplace-view-API-documentation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 

Repository files navigation

Minecraft.net Marketplace view API documentation

The API endpoints currently listed are outdated due to a Mojang migration to a different service.

API Endpoints

➡️ All requests are GET requests.

➡️ The user-agent header is REQUIRED. The minimal is browser/version for example, "Firefox/86".

Endpoint Description Requirements Status Codes
/bin/minecraft/productmanagement.productdetails.json Returns the item details of the provided item ID id (Item ID) 200 OK, 404 Not Found
/bin/minecraft/productmanagement.autosuggest.json Returns Marketplace items based on the search term locate, term (Not required but always null if not there) 200 OK, 404 Not Found
/bin/minecraft/productmanagement.productsinfobytype.json Returns items with the same type provided locate, type 200 OK, 404 Not Found
/bin/minecraft/productmanagement.productsbydescrpition.json (They misspelled description) Returns Marketplace items based on the search term, description based locate, term (not required but always null if not there), limit (If no limit, the request returns the same item everytime) 200 OK, 404 Not Found
/bin/minecraft/productmanagement.uuiddata.json Returns an item based an UUID from packIdentity locate, uuid (UUID from the packIdentity property), type (Required, but can be set to any value without affecting the result) 200 OK, 404 Not Found
/bin/minecraft/productmanagement.categorydata.json Returns all of the items from a specific category locate, category 200 OK, 404 Not Found
/bin/minecraft/productmanagement.filterproduct.json Shows all the items for a specific creator locate, creatorId (Creator name), limit, skip 200 OK, 404 Not Found, 500 Invalid Input
/bin/minecraft/productmanagement.promotiondetails.json Returns the current promotioned items if available locale 200 OK, 404 Not Found
/bin/minecraft/productmanagement.mostpopproducts.json Returns the current most popular item locate 200 OK, 404 Not Found
/bin/minecraft/productmanagement.freeproducts.json Returns free Marketplace items locate 200 OK, 404 Not Found
/bin/minecraft/productmanagement.saleproducts.json Returns the sale details of the provided item ID locate, id (item IDs seperated by ",") 200 OK, 404 Not Found, 500 Invalid Input

Query Strings

  • locale (Area code)

  • type (Item type)

  • limit (Number of items to view | The number of items are one less than the input | Defaults to 10 or 4 depending on the endpoint)

  • skip (Skip the first items | Defaults to 0)

  • currentDate (ISO date format)

  • term (Search term | Defaults to "null")

Possible Types

  • all (Most Popular)
  • resourcepack (Texture Packs)
  • addon (Add-ons)
  • mashup (Mash-ups)
  • skinpack (Skin Packs)
  • mini_game_world (Mini Games)
  • adventure_world (Adventure Maps)
  • survival_spawn_world (Survival Spawns)
  • bundle (Bundles)
  • genre.educational (Educational content)

Possible Categories

  • Newly Added
  • Most Popular Minecraft Skins
  • Most Popular Minecraft Resources
  • Most Popular Minecraft Add-ons
  • Most Popular Minecraft Mash-ups
  • Most Popular Adventure
  • Most Popular Minigames
  • Most Popular Survival Spawn

Examples

Get item details: https://www.minecraft.net/bin/minecraft/productmanagement.productdetails.json?id=8500d60c-bf43-48dd-b6e9-a97cb35e41f8

Get item details with sale info for two items: https://www.minecraft.net/bin/minecraft/productmanagement.saleproducts.json?locale=en-us&id=3fc4615d-6813-440c-8444-eafc621846f5,527c6522-2f1d-40ca-b807-87ad8e354211

Search: https://www.minecraft.net/bin/minecraft/productmanagement.autosuggest.json?locale=en-us&term=help

Search by description: https://www.minecraft.net/bin/minecraft/productmanagement.productsbydescrpition.json?locale=en-us&term=help&limit=10

Creator search: https://www.minecraft.net/bin/minecraft/productmanagement.filterproduct.json?limit=10&creatorId=Yeggs&locale=en-us&skip=0

Shows the first 100 skin packs: https://www.minecraft.net/bin/minecraft/productmanagement.productsinfobytype.json?type=skinpack&locale=en-us&limit=100&skip=0

Shows the first 120 items and doesnt show the first 20: https://www.minecraft.net/bin/minecraft/productmanagement.productsinfobytype.json?type=skinpack&locale=en-us&limit=100&skip=20

Category search: https://www.minecraft.net/bin/minecraft/productmanagement.categorydata.json?locale=en-us&category=Most%20Popular%20Minecraft%20Skins

Free items: https://www.minecraft.net/bin/minecraft/productmanagement.freeproducts.json?locale=en-us&limit=25

About

Full documentation of the Minecraft.net Marketplace API with examples.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published