{
"openapi": "3.0.1",
"info": {
"title": "Hotmart Marketplace Scraper – Courses, Ratings & Creators",
"description": "Hotmart Marketplace products scraper: courses and ebooks with ratings, review counts, creator names, categories, topics, payment options (PIX, boleto, card), plus optional price, students, rating breakdown and latest reviews. Search by keyword, category, topic or language. No login.",
"version": "1.0",
"x-build-id": "bXpRe6gxy39P5juph"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/openharvest~hotmart-marketplace-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-openharvest-hotmart-marketplace-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/openharvest~hotmart-marketplace-scraper/runs": {
"post": {
"operationId": "runs-sync-openharvest-hotmart-marketplace-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/openharvest~hotmart-marketplace-scraper/run-sync": {
"post": {
"operationId": "run-sync-openharvest-hotmart-marketplace-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchQuery": {
"title": "Search keyword",
"type": "string",
"description": "Keyword to search the Hotmart Marketplace for, as in the marketplace search box. Leave empty to browse the whole catalog (filtered by the options below)."
},
"maxItems": {
"title": "Max products",
"minimum": 0,
"type": "integer",
"description": "Maximum number of products to save. You pay per product, so this also caps your cost. Set 0 for no limit (Hotmart lists at most about 10,000 results per search).",
"default": 50
},
"categories": {
"title": "Categories",
"type": "array",
"description": "Only products in these Hotmart categories.",
"items": {
"type": "string",
"enum": [
"animals_and_plants",
"business_and_careers",
"building_and_constructing",
"design",
"education",
"environment",
"fashion_and_beauty",
"finance",
"gastronomy",
"general",
"health_and_sports",
"idioms",
"information_technology",
"internet",
"law",
"literature",
"music_and_arts",
"personal_development",
"software",
"spirituality"
],
"enumTitles": [
"Animals & plants",
"Business & careers",
"Building & construction",
"Design",
"Education",
"Environment",
"Fashion & beauty",
"Finance",
"Gastronomy",
"General",
"Health & sports",
"Languages",
"Information technology",
"Internet",
"Law",
"Literature",
"Music & arts",
"Personal development",
"Software",
"Spirituality"
]
}
},
"topics": {
"title": "Topics",
"type": "array",
"description": "Only products with these Hotmart topic slugs (the topic field in the output), for example excel, marketing-digital, emagrecimento, concurso, investimentos.",
"items": {
"type": "string"
}
},
"topicGroups": {
"title": "Topic groups",
"type": "array",
"description": "Only products in these Hotmart topic groups (the topification field), for example marketing-e-vendas, moda-e-beleza, saude-e-esportes, financas-e-negocios.",
"items": {
"type": "string"
}
},
"formats": {
"title": "Product formats",
"type": "array",
"description": "Only these product formats.",
"items": {
"type": "string",
"enum": [
"online_services",
"ebooks",
"software",
"templates"
],
"enumTitles": [
"Online courses & services",
"Ebooks",
"Software",
"Templates"
]
}
},
"paymentOptions": {
"title": "Payment options",
"type": "array",
"description": "Only products that accept these payment methods.",
"items": {
"type": "string",
"enum": [
"PIX",
"CREDIT_CARD",
"BILLET",
"PAYPAL",
"MULTIPLE_CREDIT_CARDS",
"DIRECT_DEBIT",
"VIRTUAL_DEBIT_CARD",
"HOTMART_ACCOUNT_BALANCE",
"BILLET_MOBILE"
],
"enumTitles": [
"PIX",
"Credit card",
"Boleto",
"PayPal",
"Two credit cards",
"Direct debit",
"Virtual debit card",
"Hotmart balance",
"Boleto (mobile)"
]
}
},
"languages": {
"title": "Product languages",
"type": "array",
"description": "Only products in these languages. Without this filter Hotmart mostly returns Portuguese (Brazil) products.",
"items": {
"type": "string",
"enum": [
"PT_BR",
"ES",
"EN",
"FR",
"IT",
"DE",
"AR",
"JA"
],
"enumTitles": [
"Portuguese (Brazil)",
"Spanish",
"English",
"French",
"Italian",
"German",
"Arabic",
"Japanese"
]
}
},
"sort": {
"title": "Sort by",
"enum": [
"most_relevant",
"most_recent",
"most_rated",
"best_rated"
],
"type": "string",
"description": "Result order.",
"default": "most_relevant"
},
"minRating": {
"title": "Minimum rating",
"minimum": 0,
"maximum": 5,
"type": "number",
"description": "Skip products with an average rating below this value (0-5). Products without a rating are skipped when this is above 0. Skipped products are not charged.",
"default": 0
},
"minReviews": {
"title": "Minimum number of reviews",
"minimum": 0,
"type": "integer",
"description": "Skip products with fewer reviews than this. Skipped products are not charged.",
"default": 0
},
"includeDetails": {
"title": "Include details, price & review summary",
"type": "boolean",
"description": "Also open every product page to add price and currency, max installments, number of students, warranty, modules and lessons, tags, full sales copy, creator badges, the star-rating breakdown, per-question ratings and the latest review texts. Slower, and charged as an extra product-detail event per product.",
"default": false
},
"maxReviewsPerProduct": {
"title": "Latest reviews per product",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "How many of the latest review texts to include per product in details mode (Hotmart shows up to about 10 publicly). Reviewer names are never included.",
"default": 5
},
"productUrls": {
"title": "Product URLs (instead of search)",
"type": "array",
"description": "Optional. Hotmart Marketplace product links such as https://hotmart.com/pt-br/marketplace/produtos/curso-de-excel-15/I23144995P. When set, the search options are ignored and each product is scraped in details mode.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Usually not needed. Prices in details mode are shown in the currency Hotmart uses for the country of the request IP - use an Apify Proxy with country BR to get prices in BRL.",
"default": {
"useApifyProxy": false
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}