{ "openapi": "3.0.1", "info": { "title": "Reddit Trends Scraper With Author Contact Leads", "description": "Reddit Trends Scraper — Discover trending Reddit topics, posts, communities, and authors while extracting engagement metrics, post details, and publicly available author contact information. Build lead lists for audience research, trend analysis, outreach, and market intelligence.", "version": "0.1", "x-build-id": "9qeoj6ZfKuhHx1rp2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~reddit-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-reddit-trends-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/simpleapi~reddit-trends-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-reddit-trends-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/simpleapi~reddit-trends-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-reddit-trends-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": [ "startUrls" ], "properties": { "startUrls": { "title": "🎯 Reddit Sources (subreddits, users, keywords, URLs)", "type": "array", "description": "Add subreddit URLs (e.g. https://old.reddit.com/r/startups/), r/subreddit shorthand, u/username, a full post/user URL, or a plain keyword to search. Each source is expanded into posts, and every post author is enriched. Supports bulk input.", "items": { "type": "string" } }, "sortBy": { "title": "🔀 Sort Posts By", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "How the source listing is sorted before authors are collected. Example: sortBy=top surfaces the highest-authority posters. Default is hot.", "default": "hot" }, "maxLeads": { "title": "📦 Maximum Leads (Posts)", "minimum": 1, "type": "integer", "description": "Maximum number of posts (each becomes one enriched author-lead row) to collect per source. Example: maxLeads=25. Default is 10.", "default": 10 }, "enrichAuthors": { "title": "👤 Enrich Author Authority", "type": "boolean", "description": "Look up each post author via their public /user//about.json profile to add total/link/comment karma, account creation date, account age in days, verified, gold, mod/employee, and the has-verified-email reachability flag. Turn OFF to return only the base post fields. Default is ON.", "default": true }, "maxAuthorLookups": { "title": "🔢 Max Author Lookups", "minimum": 0, "type": "integer", "description": "Cap the number of unique author profile lookups per run to control runtime on large sources. 0 = unlimited. Authors beyond the cap still appear as rows but without enrichment. Default is 0.", "default": 0 }, "extractContacts": { "title": "📇 Mine Public Contacts", "type": "boolean", "description": "Best-effort scrape of an email address and external links from the author's PUBLIC profile bio. Coverage is thin — Reddit does not expose emails on-platform, so most authors yield no email (the field is left null, never faked). The has-verified-email flag above is the reliable reachability signal. Default is ON.", "default": true }, "emailDomainFilter": { "title": "✉️ Email Domain Filter", "type": "array", "description": "Only keep a mined email when it ends with one of these domains (e.g. gmail.com, hey.com, yourcompany.com). Leave empty to accept any domain. Applies to the mined authorContactEmail only.", "items": { "type": "string" } }, "contactsOnly": { "title": "🎯 Output Reachable Authors Only", "type": "boolean", "description": "Emit only rows whose author is reachable — a mined email, a mined external link, OR a verified-email account. Everything else is dropped. Default is OFF (every post is emitted).", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy used for all requests. Reddit blocks datacenter IPs, so this actor defaults to Apify RESIDENTIAL proxy; an explicit proxy group you set here is honored." } } }, "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 } } } } } } } } } }