{ "openapi": "3.0.1", "info": { "title": "Mastodon $1đŸ’° URL, Trend & Profile Scraper", "description": "From $1/1K. Scrape trending Mastodon profiles and related posts from any instance’s public API. Returns rich profile data, follower counts, bios, avatars, fields, and thread replies. Supports nested profile reviews or flat review output.", "version": "1.0", "x-build-id": "BtUJEkSQUskmW273e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~mastodon-social-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-mastodon-social-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/abotapi~mastodon-social-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-mastodon-social-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/abotapi~mastodon-social-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-mastodon-social-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", "required": [ "mode" ], "properties": { "mode": { "title": "Output mode", "enum": [ "profiles", "reviews", "keyword" ], "type": "string", "description": "What the actor returns. 'profiles' = one record per trending profile with its reviews nested inside. 'reviews' = one flat record per review (a post or a reply). 'keyword' = bulk posts for the keywords you list, one flat record per post, walked via load-more pagination (the high-volume option).", "default": "profiles" }, "instanceUrl": { "title": "Mastodon instance", "type": "string", "description": "Which Mastodon server to read the explore page from. Defaults to mastodon.social. Any public Mastodon instance works (for example https://mas.to or https://fosstodon.org).", "default": "https://mastodon.social" }, "profileSource": { "title": "Trending profile source", "enum": [ "trending", "directory", "both" ], "type": "string", "description": "Where trending profiles come from. 'trending' = the authors of currently trending posts. 'directory' = the active public profile directory. 'both' = the two merged and deduped. Only applies when no URLs are provided.", "default": "both" }, "onlyLocal": { "title": "Local accounts only", "type": "boolean", "description": "When using the directory source, return only accounts that are local to the chosen instance (skip federated accounts from other servers).", "default": false }, "urls": { "title": "Profile or post URLs (optional)", "type": "array", "description": "Optional. Paste Mastodon profile URLs (https://mastodon.social/@username) or post URLs (https://mastodon.social/@username/123456789). When provided, the explore search is skipped and the actor scrapes exactly these instead. Leave empty to use profiles, reviews, or keyword mode. Multiple URLs supported.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords (keyword mode)", "type": "array", "description": "Topics to bulk-scrape when mode is 'keyword'. Enter one word per entry, with or without a leading # (for example: news, art, climate). Each keyword is matched as a Mastodon tag and its public timeline is walked back via load-more pagination up to Max posts. Note: keywords match single tags, not free-text phrases (free-text search needs a token).", "items": { "type": "string" } }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Fetch the reply thread under each post. Replies are added as reviews of type 'reply'. Turning this off makes runs faster and cheaper (one fewer request per post).", "default": true }, "maxProfiles": { "title": "Max profiles", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of trending profiles to scrape (profiles mode, or as review sources in reviews mode).", "default": 10 }, "maxReviewsPerProfile": { "title": "Max posts per profile", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many of each profile's most recent posts to fetch. The profile timeline is walked back via load-more pagination, so you can pull deep history (up to 5000). Each post may also bring its replies (see Include replies).", "default": 5 }, "maxRepliesPerPost": { "title": "Max replies per post", "minimum": 0, "maximum": 200, "type": "integer", "description": "Cap on how many replies to keep per post when Include replies is on.", "default": 10 }, "maxReviews": { "title": "Max reviews (reviews mode)", "minimum": 0, "type": "integer", "description": "Hard cap on total reviews returned in reviews mode. 0 means unlimited (bounded by the profile and per-post limits above).", "default": 0 }, "maxPosts": { "title": "Max posts (keyword mode)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on total posts returned in keyword mode, split evenly across the keywords you list. Each keyword timeline is walked via load-more until this many posts are collected.", "default": 500 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. The Mastodon API is public, so Apify Datacenter proxy (the default) is enough. Datacenter also rotates exit IPs, which keeps runs under the per-IP rate limit on large jobs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }