{
  "openapi": "3.0.1",
  "info": {
    "title": "DEV Scraper | Articles, Full Text and Authors",
    "description": "DEV Scraper for dev.to: search DEV Community articles by keyword, tag, author or organization and get each one with its full text in Markdown, likes, unicorns, saves and comments, plus the author bio, location, GitHub, LinkedIn and public email. 20 articles in 17 seconds, 41 fields each. No login.",
    "version": "1.0",
    "x-build-id": "oFbX9ssHh1RCyziYK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~dev-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-dev-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/silentflow~dev-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-dev-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/silentflow~dev-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-dev-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": {
          "searchQueries": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "What you would type in DEV's search box: a technology (<code>rust</code>), a topic (<code>ai agents</code>) or a product name. It searches the 870,000+ articles of DEV's search, titles, tags, authors and text. <b>Newest first</b> goes through every match; <b>Top</b> and <b>Best match</b> read the 1,000 best matches.",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "title": "🏷️ Tags",
            "type": "array",
            "description": "DEV tags, as written after the # on the site: <code>javascript</code>, <code>webdev</code>, <code>python</code>, <code>devops</code>. <code>#JavaScript</code> and tag links such as <code>https://dev.to/t/javascript</code> work too. Big tags hold more than 10,000 articles.",
            "items": {
              "type": "string"
            }
          },
          "usernames": {
            "title": "👤 Authors or organizations",
            "type": "array",
            "description": "DEV usernames of people or organizations, newest article first: <code>ben</code>, <code>devteam</code>, <code>@aws-builders</code>, or a profile link such as <code>https://dev.to/ben</code>. An organization gives the articles every member published under its name.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 DEV links",
            "type": "array",
            "description": "Paste any of these DEV pages:<ul><li>an article: <code>https://dev.to/ben/my-article-1abc</code></li><li>a profile: <code>https://dev.to/ben</code></li><li>a tag, with its top view if you like: <code>https://dev.to/t/rust/top/month</code></li><li>a search: <code>https://dev.to/search?q=kubernetes</code></li><li>the main feed: <code>https://dev.to/top/week</code>, <code>https://dev.to/latest</code></li></ul>Article links are read first, so the limit never leaves them out.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "🔢 Max articles",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many articles across all keywords, tags, authors and links. An article found by two sources is delivered once. In our tests 20 articles with full text and author profiles took 15 to 17 seconds from a keyword, and 25 articles took 6 seconds from a tag.",
            "default": 50
          },
          "sort": {
            "title": "↕️ Sort",
            "enum": [
              "newest",
              "top_week",
              "top_month",
              "top_year",
              "top_all",
              "rising",
              "relevance"
            ],
            "type": "string",
            "description": "<b>Newest first</b> follows publication. <b>Top of the week, month, year or all time</b> is DEV's own Top view for tags and the main feed; for an author or a keyword it orders the period's articles by reactions. <b>Rising</b> is DEV's rising view of the last days. <b>Best match</b> orders keywords by relevance. A link that carries its own view, such as <code>/t/rust/top/month</code>, keeps it.",
            "default": "newest"
          },
          "publishedAfter": {
            "title": "📅 Published after",
            "type": "string",
            "description": "Keep only articles published from this date: a day such as <code>2026-11-01</code>, or a span back from now such as <code>24 hours</code>, <code>7 days</code> or <code>1 month</code>. Newest-first runs stop as soon as they pass it. Leave empty for no date limit."
          },
          "minReactions": {
            "title": "❤️ Minimum reactions",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only articles with at least this many reactions (likes, unicorns, exploding heads, raised hands and fire). <code>0</code> keeps everything. A high value on a newest-first feed reads many articles to find a few.",
            "default": 0
          },
          "includeDetails": {
            "title": "📄 Full text, reactions and author profile",
            "type": "boolean",
            "description": "Add the full article in Markdown with its word count, the count of each reaction type and of saves, and the author's public profile: bio, location, work, education, join date, public email, GitHub, X, LinkedIn and website, posts and comments written. Turn off for card data only (title, tags, author name, counts, dates): 1,000 articles of a tag took 2 seconds in our tests, with those columns left empty.",
            "default": 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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}