{ "openapi": "3.0.1", "info": { "title": "Buildside Scraper — Indie Founders, Products and Posts", "description": "Export Buildside's indie founders (bio, expertise, challenges, city, country, socials, followers, products), startup products (pitch, category, stage, features, website, public MRR) and build-in-public posts with comments. Filters and a date filter for posts. No login.", "version": "0.1", "x-build-id": "60IeyxPcwC30gMNQ8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/teodor_banea~buildside-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-teodor_banea-buildside-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/teodor_banea~buildside-scraper/runs": { "post": { "operationId": "runs-sync-teodor_banea-buildside-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/teodor_banea~buildside-scraper/run-sync": { "post": { "operationId": "run-sync-teodor_banea-buildside-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": { "mode": { "title": "What to export", "enum": [ "founders", "products", "posts" ], "type": "string", "description": "Choose the data set. Founders: one row per public founder profile (bio, expertise, challenges, location, socials, followers, products). Products: one row per product (pitch, category, stage, features, website, public revenue). Posts: one row per build-in-public post (text, type, reactions, optional comments), newest first.", "default": "founders" }, "maxResults": { "title": "Maximum results", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Stop after this many rows (founders, products or posts). Set 0 for everything that matches — the whole site is a few hundred founders and products and about 1,300 posts.", "default": 500 }, "query": { "title": "Search text", "type": "string", "description": "Founders and products: Buildside's own search (names, handles, bios, pitches and expertise tags). Posts: every word must appear in the post title, text or details. Leave empty for everything." }, "expertise": { "title": "Expertise", "type": "array", "description": "Keep founders with ANY of these areas of expertise (in posts mode: posts by these founders).", "items": { "type": "string", "enum": [ "AI", "Analytics", "Bootstrapping", "Community", "Design", "Engineering", "Growth", "Marketing", "No-code", "Pricing", "Product", "Sales" ], "enumTitles": [ "AI", "Analytics", "Bootstrapping", "Community", "Design", "Engineering", "Growth", "Marketing", "No-code", "Pricing", "Product", "Sales" ] } }, "founderTypes": { "title": "Founder types", "type": "array", "description": "Keep founders of ANY of these types.", "items": { "type": "string", "enum": [ "Solo", "Small team", "Technical", "Non-technical", "First-time", "Repeat", "Funded" ], "enumTitles": [ "Solo", "Small team", "Technical", "Non-technical", "First-time", "Repeat", "Funded" ] } }, "statuses": { "title": "Founder status", "type": "array", "description": "Keep founders in ANY of these phases.", "items": { "type": "string", "enum": [ "Exploring", "Building", "Growing", "Supporting founders" ], "enumTitles": [ "Exploring", "Building", "Growing", "Supporting founders" ] } }, "verifiedOnly": { "title": "Verified founders only", "type": "boolean", "description": "Keep only founders with Buildside's verified badge.", "default": false }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Keep founders with at least this many Buildside followers. Leave empty for no minimum." }, "founderSortBy": { "title": "Sort founders by", "enum": [ "followers", "newest" ], "type": "string", "description": "Order of founder rows — and which founders come first when Maximum results stops the run.", "default": "followers" }, "categories": { "title": "Categories", "type": "array", "description": "Keep products (and posts) in ANY of these product categories.", "items": { "type": "string", "enum": [ "ai", "book-formatting", "cloud-infrastructure", "collaboration", "communication", "creative-agency", "customer-support", "developer-tools", "dev-tools", "e-commerce", "education", "finops", "fintech", "games", "healthcare", "job-hunt", "marketing-tools", "other", "photo-albums", "photo-editor", "product-discovery", "productivity", "sales", "security", "social-media" ], "enumTitles": [ "AI", "Book formatting", "Cloud infrastructure", "Collaboration", "Communication", "Creative agency", "Customer support", "Developer tools", "Dev tools", "E-commerce", "Education", "FinOps", "Fintech", "Games", "Healthcare", "Job hunt", "Marketing tools", "Other", "Photo albums", "Photo editor", "Product discovery", "Productivity", "Sales", "Security", "Social media" ] } }, "stages": { "title": "Product stages", "type": "array", "description": "Keep products in ANY of these stages.", "items": { "type": "string", "enum": [ "Pre-launch", "Beta", "Growth", "Mature" ], "enumTitles": [ "Pre-launch", "Beta", "Growth", "Mature" ] } }, "publicRevenueOnly": { "title": "Only products with public revenue", "type": "boolean", "description": "Keep only products whose founder publishes an MRR above zero (self-reported or Stripe-verified). Same rule as Buildside's own revenue filter.", "default": false }, "productSortBy": { "title": "Sort products by", "enum": [ "newest", "followers", "mrr" ], "type": "string", "description": "Order of product rows.", "default": "newest" }, "postTypes": { "title": "Post types", "type": "array", "description": "Keep posts of ANY of these types. Leave empty for all types.", "items": { "type": "string", "enum": [ "Progress", "Launch", "Milestone", "Lesson", "Ask", "Feedback", "Experiment", "Opportunity", "Challenge", "Repost" ], "enumTitles": [ "Progress", "Launch", "Milestone", "Lesson", "Ask", "Feedback", "Experiment", "Opportunity", "Challenge", "Repost" ] } }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Keep posts published on or after this date, or within a recent period (e.g. 7 days). Older posts are skipped." }, "includeReposts": { "title": "Include reposts", "type": "boolean", "description": "Also export reposts (a founder sharing someone else's post — the row links to the original). Off: original posts only.", "default": false }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Add each post's comments and replies (author handle, name, text, date) to its row. Adds one request per post that has comments, plus one per comment with replies — slower on large runs.", "default": false }, "includeProducts": { "title": "Include each founder's products", "type": "boolean", "description": "Founders mode: add the founder's products (id, name, pitch, link) to the row. Costs one small list read per run.", "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 } } } } } } } } } }