Because Kickstarter public API does not provide structured output of search results, you can get list of Kickstarter news and projects with this app (actor).
- Unit tests
- Compare current run with previous one and output only new projects
You can manage search results in any languague (Python, PHP, Node JS/NPM). See the FAQ or our API reference to learn more about getting results from this Kickstarter Search Actor. The code of this Kickstarter search actor is also open source, so you can create your own solution if you need.
Input of this actor should be JSON containing filter specification. Allowed filters are:
| Field | Type | Description | Allowed values |
|---|---|---|---|
| query | String | Search term | Any string value |
| category | String | Category to search in | Category slug from this list |
| location | String / Number | Location to search around | Either a name of the location or ID of the location |
| status | String | State of the project | One of: "All", "Live", "Successful" |
| pledged | String | Amount pledged | One of: "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" |
| goal | String | Goal amount | One of: "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" |
| raised | String | Amount raised | One of: "All" "< 75% raised" "75% to 100% raised" "> 100% raised" |
| sort | String | Sort order | One of: "pupularity", "newest", "end_date", "most_funded", "most_backed" |
| maxResults | Number | Maximum number of projects in output | Positive number, 0 for up to 2400 results |
| datasetName | String | Name of dataset that will be overwritten with data on each run | Alphabet characters, numbers and dash (e.q. my-dataset) |
Location - If you provide location to the Kickstarter search actor and it's set a string, it will run another actor to find ID associated with the location. Once the location is found, it will be outputed in the console. Next time if you provide the numeric ID instead of the location, it will not do the lookup again.
This option requires access to Apify Proxy, if you do not have access to it, then the actor will fail. You can avoid this by going to Kickstarter, looking up anything and selecting the location you want. Then in addressbar of your browser you should see that the address now contains "woe_id" parameter. If you copy it's value into the location field of this actor. It will use it instead and you will not need to use proxy.
maxResults - Kickstarter will return a maximum of 200 pages, which is 2400 results. To get more results then this limit run multiple instances of this actor with more specific search terms.
datasetName - If you provide name of a named dataset then all everytime you run this Kickistarter search actor, it will clear the dataset and write new data into it. You can use this option for example if you want to use named dataset as RSS feed or if you are creating an API.
During the run, the actor will output messages letting the you know what is going on.
If you provide incorrect input the Kickstarter search actor, it will immediately stop with Failure state and output an explanation of what is wrong.
Once input is properly parsed the actor will load first page of results and output information about the number of found results and how many results are remaining.
Every 10th page load will output prediction of how long it will take for the run to finish.
During the run, the actor is storing results into dataset, each project is a separate item in the dataset and it's structure looks like this:
{
"id": 1483913924,
"photo": "https://ksr-ugc.imgix.net/assets/023/834/770/03501faf6f2185aaa61162c6b2fa7810_original.jpg?ixlib=rb-1.1.0&crop=faces&w=560&h=315&fit=crop&v=1547938069&auto=format&frame=1&q=92&s=8ba5a9c1fd72ebc374dcd6a316643fa2",
"name": "\"Nothing Left To Prove\" CD and Vinyl Release",
"blurb": "This is a campaign to see a physical release for Joey Allcorn's 2013 album \"Nothing Left To Prove\"",
"goal": 4500,
"pledged": 318,
"state": "live",
"slug": "nothing-left-to-prove-cd-and-vinyl-release",
"disable_communication": false,
"country": "US",
"currency": "USD",
"currency_symbol": "$",
"currency_trailing_code": true,
"deadline": 1552093200,
"state_changed_at": 1547938512,
"created_at": 1547932710,
"launched_at": 1547938511,
"staff_pick": false,
"is_starrable": true,
"backers_count": 9,
"static_usd_rate": 1,
"usd_pledged": "318.0",
"converted_pledged_amount": 318,
"fx_rate": 1,
"current_currency": "USD",
"usd_type": "domestic",
"spotlight": false,
"creatorId": 60316774,
"creatorName": "Joey Allcorn",
"creatorAvatar": "https://ksr-ugc.imgix.net/assets/023/834/796/cc0be4c0a1b2353c73b2580b5179453a_original.jpg?ixlib=rb-1.1.0&w=160&h=160&fit=crop&v=1547938330&auto=format&frame=1&q=92&s=21522c8166e3d904536376c080561cc3",
"creatorUrl": "https://www.kickstarter.com/profile/joeyallcorn",
"locationId": 2457170,
"locationName": "Nashville, TN",
"categoryId": 37,
"categoryName": "Country & Folk",
"categorySlug": "music/country & folk",
"url": "https://www.kickstarter.com/projects/joeyallcorn/nothing-left-to-prove-cd-and-vinyl-release?ref=category_location",
"title": "\"Nothing Left To Prove\" CD and Vinyl Release",
"description": "This is a campaign to see a physical release for Joey Allcorn's 2013 album \"Nothing Left To Prove\"",
"link": "https://www.kickstarter.com/projects/joeyallcorn/nothing-left-to-prove-cd-and-vinyl-release?ref=category_location",
"pubDate": "Sat, 19 Jan 2019 22:55:11 +0000",
"created_at_formatted": "Sat, 19 Jan 2019 21:18:30 +0000",
"launched_at_formatted": "Sat, 19 Jan 2019 22:55:11 +0000"
}