{
  "openapi": "3.0.1",
  "info": {
    "title": "BetaList Scraper | Startups, Websites and Contacts",
    "description": "BetaList scraper for new startup launches: search by keyword, topic, category or featured date and get each startup with its real website, emails, phone and social profiles, plus makers, topics and description. 20 startups in 12 seconds, 21 fields each. Build 2026 lead lists, no BetaList account.",
    "version": "1.0",
    "x-build-id": "EcanDbLAueS537yIQ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~betalist-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-betalist-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~betalist-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-betalist-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~betalist-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-betalist-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 BetaList's search box: a product type (<code>crm</code>), a market (<code>fintech</code>) or a startup name. BetaList gives up to 60 best matches per keyword, by relevance, over its whole history since 2010. Add a featured date below to keep only recent launches.",
            "items": {
              "type": "string"
            }
          },
          "topics": {
            "title": "🏷️ Topics or categories",
            "type": "array",
            "description": "BetaList topics, newest launches first: a name (<code>SaaS</code>, <code>Generative AI</code>, <code>Fintech</code>) or a topic link. A category name (<code>AI</code>, <code>Finance</code>, <code>Dev Tools</code>, <code>Marketing</code>) reads every topic of that category. The 22 categories are listed on betalist.com/browse.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 BetaList links",
            "type": "array",
            "description": "Paste any of these BetaList pages:<ul><li>a startup: <code>https://betalist.com/startups/parroli</code></li><li>a topic or a category: <code>https://betalist.com/browse/ai/generative-ai</code>, <code>https://betalist.com/browse/finance</code></li><li>a search: <code>https://betalist.com/search?q=crm</code></li><li>a region: <code>https://betalist.com/regions/france</code></li><li>a maker profile: <code>https://betalist.com/@everygenai</code></li><li>the latest startups feed: <code>https://betalist.com/startups</code></li></ul>Each startup becomes one row, read in full.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "featuredAfter": {
            "title": "📅 Featured after",
            "type": "string",
            "description": "First featured day to keep, included: a day such as <code>2026-11-01</code>, or a span back from today such as <code>7 days</code> or <code>1 month</code>. Leave empty for no start date."
          },
          "featuredBefore": {
            "title": "📅 Featured before",
            "type": "string",
            "description": "Last featured day to keep, included, such as <code>2026-10-31</code>. The run goes straight to that day on the latest feed and on topics. Leave empty to run up to today."
          },
          "maxItems": {
            "title": "🔢 Max startups",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Stop after this many startups across all keywords, topics and links. BetaList featured 30 startups over the last 3 days of our test and holds about 28,000 since 2010. In our tests 20 startups with their website contacts took 11 to 13 seconds.",
            "default": 50
          },
          "includeContacts": {
            "title": "📇 Website contacts",
            "type": "boolean",
            "description": "Open each startup's website and add the emails, phone and social profiles (X, LinkedIn, Facebook, Instagram, YouTube, TikTok, GitHub) it publishes, plus whether the site is still online. Turn off for BetaList data only, which runs faster and leaves the contact columns empty.",
            "default": true
          },
          "resumeCursor": {
            "title": "↩️ Resume from earlier runs",
            "type": "array",
            "description": "Pick the dataset of an earlier run of this actor. Its ID, such as <code>WkzbQMuFYuamGv3YF</code>, is on the last lines of that run's log and in its Storage tab. The startups it delivered are skipped, neither read nor charged again, and this run carries on with the rest, with the same keywords, topics and links. To resume a run that was itself resumed, add every dataset the log names. Leave empty for a fresh run."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}