{ "openapi": "3.0.1", "info": { "title": "Dev.to Article Scraper — Tags, Authors & Full Text", "description": "Scrape Dev.to articles by tag, author, keyword search, or top posts via the official Forem public API. No proxy, no auth. Returns title, tags, reactions, comments, reading time, author, published date, and optional body markdown. Pay per article.", "version": "0.1", "x-build-id": "KFgoHN3cK4JB72WEa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~devto-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-devto-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/bovi~devto-scraper/runs": { "post": { "operationId": "runs-sync-bovi-devto-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/bovi~devto-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-devto-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": "Mode", "enum": [ "byTag", "byUsername", "byArticleIds", "search", "top" ], "type": "string", "description": "Scraping mode. Pick one: 'byTag' — fetch articles by tag (requires 'tags'); 'byUsername' — all articles by author (requires 'usernames'); 'byArticleIds' — specific articles (requires 'articleIds'); 'search' — full-text search (requires 'searchQueries'); 'top' — top articles by reactions over last N days (uses 'topDays'). Default 'byTag'." }, "tags": { "title": "Tags (mode=byTag)", "type": "array", "description": "One or more Dev.to tag slugs to fetch articles for. Each tag runs separately and results are merged. Example: [\"python\", \"javascript\", \"webdev\"]. Used only when mode='byTag'.", "items": { "type": "string" } }, "usernames": { "title": "Author usernames (mode=byUsername)", "type": "array", "description": "Dev.to @handles to fetch all articles from. Example: [\"ben\", \"t_jallice\"]. Used only when mode='byUsername'.", "items": { "type": "string" } }, "articleIds": { "title": "Article IDs (mode=byArticleIds)", "type": "array", "description": "Specific numeric Dev.to article IDs to fetch, e.g. [\"3745852\", \"1234567\"]. Each ID is fetched via the detail endpoint — body_markdown is always available regardless of includeBody. Used only when mode='byArticleIds'.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries (mode=search)", "type": "array", "description": "Full-text keyword queries against Dev.to's search index. Each query runs separately and results are merged. Example: [\"vector databases\", \"rust async\"]. Used only when mode='search'.", "items": { "type": "string" } }, "topDays": { "title": "Top articles — days (mode=top)", "minimum": 1, "type": "integer", "description": "Fetch top articles by reactions from the last N days. Common values: 7 (weekly), 30 (monthly), 365 (yearly). Used only when mode='top'." }, "maxItems": { "title": "Max articles total", "minimum": 0, "type": "integer", "description": "Maximum total articles to return across all tags/usernames/queries. Set to 50–200 for agent use to avoid large payloads. 0 = no limit.", "default": 100 }, "includeBody": { "title": "Include body markdown", "type": "boolean", "description": "Fetch full article body in Markdown format (body_markdown field). Requires one extra API call per article. Set false (default) to keep responses token-lean for agent use.", "default": 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 } } }, "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 } } } } } } } } } }