{
"openapi": "3.0.1",
"info": {
"title": "Mastodon Scraper ยท Posts, Accounts, Hashtags & Instances",
"description": "Mastodon scraper for fediverse posts, profiles, hashtags, and instance timelines. Extract public Mastodon statuses, user accounts, engagement metrics, media, and outbound links with no login required.",
"version": "1.0",
"x-build-id": "CnxhlmuI88chIO1gI"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/reapx~mastodon-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-reapx-mastodon-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/reapx~mastodon-scraper/runs": {
"post": {
"operationId": "runs-sync-reapx-mastodon-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/reapx~mastodon-scraper/run-sync": {
"post": {
"operationId": "run-sync-reapx-mastodon-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": {
"instances": {
"title": "Instances",
"type": "array",
"description": "Mastodon instance domains to read, one per line - mastodon.social, fosstodon.org, hachyderm.io, mstdn.social. Every source below is read on each instance and the results merged.
Leave this field empty to include every option.",
"items": {
"type": "string"
}
},
"hashtags": {
"title": "Hashtags",
"type": "array",
"description": "Hashtags to read, one per line, with or without the #. Each is fetched as its own timeline.
Leave this field empty to include every option.",
"items": {
"type": "string"
}
},
"accounts": {
"title": "Accounts",
"type": "array",
"description": "Accounts whose public posts to read, one per line, as user@instance or a bare username for a local account.
Leave this field empty to include every option.",
"items": {
"type": "string"
}
},
"includePublicTimeline": {
"title": "Include the instance's public timeline",
"type": "boolean",
"description": "Read each instance's public timeline. Some instances, mastodon.social among them, require a logged-in user for this and are skipped with a note rather than failing the run."
},
"includeTrending": {
"title": "Include trending posts",
"type": "boolean",
"description": "Read what each instance is currently amplifying through its trends endpoint."
},
"localOnly": {
"title": "Only posts from this instance",
"type": "boolean",
"description": "Restrict hashtag and public timelines to posts written on the instance itself, excluding federated posts from elsewhere."
},
"onlyWithMedia": {
"title": "Only posts with media",
"type": "boolean",
"description": "Keep only posts carrying at least one image, video or audio attachment."
},
"excludeReplies": {
"title": "Exclude replies",
"type": "boolean",
"description": "Drop posts that reply to another post."
},
"excludeReblogs": {
"title": "Exclude boosts",
"type": "boolean",
"description": "Drop boosts (reblogs) and keep only original posts."
},
"language": {
"title": "Language",
"type": "string",
"description": "Keep only posts the author tagged with this two-letter language code.
Leave this field empty to skip this filter."
},
"minFavourites": {
"title": "Minimum favourites",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Keep only posts with at least this many favourites - the simplest way to skim the top of a busy hashtag."
},
"maxPosts": {
"title": "Maximum posts to return",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Hard ceiling on the rows this run produces, and therefore on what it costs. You are charged per post returned.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned."
},
"requestsPerSecond": {
"title": "Requests per second",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Politeness against each instance. Mastodon instances are volunteer-run; keep this low."
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}