{
  "openapi": "3.0.1",
  "info": {
    "title": "Kickstarter Scraper 🚀",
    "description": "Extract Kickstarter campaign data including project details, funding progress, goals, backer counts, categories, creators, rewards, and launch dates. Ideal for market research, trend analysis, lead generation, investment research, and business intelligence.",
    "version": "0.1",
    "x-build-id": "E9PQjuaLhtZiAo6i6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapier~kickstarter-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapier-kickstarter-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/scrapier~kickstarter-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapier-kickstarter-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/scrapier~kickstarter-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapier-kickstarter-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": [
          "proxyConfig"
        ],
        "properties": {
          "startUrls": {
            "title": "🔗 Start URLs",
            "type": "array",
            "description": "URLs to start with. Supports 🟢 project detail, 👤 creator profile, 📂 category, 📍 place, and 🔍 /discover/advanced search URLs. Leave empty to crawl purely from the filters below.",
            "items": {
              "type": "string"
            }
          },
          "query": {
            "title": "🔍 Search Query",
            "type": "string",
            "description": "Keyword/query you want to search on Kickstarter. Ignored when Start URLs are provided."
          },
          "maxResults": {
            "title": "🎯 Maximum Results",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of project records to retrieve.",
            "default": 10
          },
          "category": {
            "title": "📂 Category",
            "enum": [
              "All",
              "art",
              "art/ceramics",
              "art/conceptual art",
              "art/digital art",
              "art/illustration",
              "art/installations",
              "art/mixed media",
              "art/painting",
              "art/performance art",
              "art/public art",
              "art/sculpture",
              "art/textiles",
              "art/video art",
              "comics",
              "comics/anthologies",
              "comics/comic books",
              "comics/events",
              "comics/graphic novels",
              "comics/webcomics",
              "crafts",
              "crafts/candles",
              "crafts/crochet",
              "crafts/diy",
              "crafts/embroidery",
              "crafts/glass",
              "crafts/knitting",
              "crafts/pottery",
              "crafts/printing",
              "crafts/quilts",
              "crafts/stationery",
              "crafts/taxidermy",
              "crafts/weaving",
              "crafts/woodworking",
              "dance",
              "dance/performances",
              "dance/residencies",
              "dance/spaces",
              "dance/workshops",
              "design",
              "design/architecture",
              "design/civic design",
              "design/graphic design",
              "design/interactive design",
              "design/product design",
              "design/typography",
              "fashion",
              "fashion/accessories",
              "fashion/apparel",
              "fashion/childrenswear",
              "fashion/couture",
              "fashion/footwear",
              "fashion/jewelry",
              "fashion/pet fashion",
              "fashion/ready-to-wear",
              "film & video",
              "film & video/action",
              "film & video/animation",
              "film & video/comedy",
              "film & video/documentary",
              "film & video/drama",
              "film & video/experimental",
              "film & video/family",
              "film & video/fantasy",
              "film & video/festivals",
              "film & video/horror",
              "film & video/movie theaters",
              "film & video/music videos",
              "film & video/narrative film",
              "film & video/romance",
              "film & video/science fiction",
              "film & video/shorts",
              "film & video/television",
              "film & video/thrillers",
              "film & video/webseries",
              "food",
              "food/bacon",
              "food/community gardens",
              "food/cookbooks",
              "food/drinks",
              "food/events",
              "food/farmer's markets",
              "food/farms",
              "food/food trucks",
              "food/restaurants",
              "food/small batch",
              "food/spaces",
              "food/vegan",
              "games",
              "games/gaming hardware",
              "games/live games",
              "games/mobile games",
              "games/playing cards",
              "games/puzzles",
              "games/tabletop games",
              "games/video games",
              "journalism",
              "journalism/audio",
              "journalism/photo",
              "journalism/print",
              "journalism/video",
              "journalism/web",
              "music",
              "music/blues",
              "music/chiptune",
              "music/classical music",
              "music/comedy",
              "music/country & folk",
              "music/electronic music",
              "music/faith",
              "music/hip-hop",
              "music/indie rock",
              "music/jazz",
              "music/kids",
              "music/latin",
              "music/metal",
              "music/pop",
              "music/punk",
              "music/r&b",
              "music/rock",
              "music/world music",
              "photography",
              "photography/animals",
              "photography/fine art",
              "photography/nature",
              "photography/people",
              "photography/photobooks",
              "photography/places",
              "publishing",
              "publishing/academic",
              "publishing/anthologies",
              "publishing/art books",
              "publishing/calendars",
              "publishing/children's books",
              "publishing/comedy",
              "publishing/fiction",
              "publishing/letterpress",
              "publishing/literary journals",
              "publishing/nonfiction",
              "publishing/periodicals",
              "publishing/poetry",
              "publishing/radio & podcasts",
              "publishing/translations",
              "publishing/young adult",
              "publishing/zines",
              "publishing/literary spaces",
              "technology",
              "technology/3d printing",
              "technology/apps",
              "technology/camera equipment",
              "technology/diy electronics",
              "technology/fabrication tools",
              "technology/flight",
              "technology/gadgets",
              "technology/hardware",
              "technology/makerspaces",
              "technology/robots",
              "technology/software",
              "technology/sound",
              "technology/space exploration",
              "technology/wearables",
              "technology/web",
              "theater",
              "theater/comedy",
              "theater/experimental",
              "theater/festivals",
              "theater/immersive",
              "theater/musical",
              "theater/plays",
              "theater/spaces"
            ],
            "type": "string",
            "description": "Kickstarter category to filter results by. Pick \"All\" for every category.",
            "default": "All"
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "Location to search within (e.g. \"Seattle, WA\" or \"United States\"). Resolved automatically. Leave empty to skip."
          },
          "status": {
            "title": "⭐ Status",
            "enum": [
              "All",
              "Live",
              "Successful"
            ],
            "type": "string",
            "description": "Filter by campaign status.",
            "default": "All"
          },
          "pledged": {
            "title": "💰 Amount Pledged",
            "enum": [
              "All",
              "< $1,000 pledged",
              "$1,000 to $10,000 pledged",
              "$10,000 to $100,000 pledged",
              "$100,000 to $1,000,000 pledged",
              "> $1,000,000 pledged"
            ],
            "type": "string",
            "description": "Filter by total amount pledged.",
            "default": "All"
          },
          "goal": {
            "title": "🎯 Goal",
            "enum": [
              "All",
              "< $1,000 goal",
              "$1,000 to $10,000 goal",
              "$10,000 to $100,000 goal",
              "$100,000 to $1,000,000 goal",
              "> $1,000,000 goal"
            ],
            "type": "string",
            "description": "Filter by the campaign's funding goal.",
            "default": "All"
          },
          "raised": {
            "title": "📈 % Raised",
            "enum": [
              "All",
              "< 75% raised",
              "75% to 100% raised",
              "> 100% raised"
            ],
            "type": "string",
            "description": "Filter by how much of the goal was raised.",
            "default": "All"
          },
          "sort": {
            "title": "↕️ Sort By",
            "enum": [
              "newest",
              "popularity",
              "end_date",
              "most_funded",
              "most_backed"
            ],
            "type": "string",
            "description": "Order of the results.",
            "default": "newest"
          },
          "datasetName": {
            "title": "🗄️ Dataset Name",
            "type": "string",
            "description": "Write results into a named dataset (persists across runs and is overwritten each run). Leave empty to use the run's default dataset.",
            "default": ""
          },
          "enrichProjects": {
            "title": "✨ Fetch Full Project Details",
            "type": "boolean",
            "description": "Fetch each project page for rewards, add-ons, items and full creator profiles. Turn off for a faster, lighter crawl that returns only the discover summary.",
            "default": true
          },
          "concurrency": {
            "title": "⚡ Concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many projects to fetch in parallel.",
            "default": 5
          },
          "requestDelay": {
            "title": "⏱️ Delay Between Requests (seconds)",
            "minimum": 0,
            "maximum": 10,
            "type": "number",
            "description": "Politeness delay; a small random jitter is added on top. Kickstarter rate-limits aggressively.",
            "default": 1
          },
          "impersonate": {
            "title": "🌐 Browser Fingerprint",
            "enum": [
              "chrome131",
              "chrome124",
              "chrome120",
              "safari17_2_ios"
            ],
            "type": "string",
            "description": "Browser TLS fingerprint to impersonate. Use a recent one — Cloudflare rejects old/generic fingerprints.",
            "default": "chrome131"
          },
          "proxyConfig": {
            "title": "🛡️ Proxy Configuration",
            "type": "object",
            "description": "The scraper starts with NO proxy and only escalates (datacenter → residential) if Kickstarter blocks it, then sticks with residential. Residential is strongly recommended — Kickstarter blocks datacenter traffic.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}