# Kickstarter · Search projects

Get product, price and seller data with Kickstarter · Search projects from Alexandria through one Spiral API key. Discover projects before fetching one with get_project. Use list_categories for category ids and search_locations for woe_ids. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: E-commerce
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `kickstarter-com/crowdfunding-projects/search_projects`
- Page: https://spiral.ai/tools/alexandria/kickstarter-com/crowdfunding-projects/search_projects

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `tag` | text |  | — | Browse a tag collection (/discover/tags/{tag}, e.g. `witchstarter`, `make-100`; slugs from list_categories.tags). Combines with `sort` and `page` only. Pattern: ^[a-z0-9][a-z0-9-]{0,80}$. |
| `goal` | number | 0 to 5 | — | Goal bucket 0..5 as on the discover page (0 = under $1,000 ... 5 = over $100,000). |
| `page` | number | 1 to 200 | 1 | 1-based page; 12 cards per page. Kickstarter answers 404 past roughly page 200. |
| `seed` | number | 0 to … | — | Shuffle seed returned by a previous page; keeps `magic` order stable while paginating. |
| `sort` | one of | magic, newest, popularity, most_funded, end_date, most_backed | magic | Kickstarter sort. `magic` is a seeded shuffle: pass the returned `seed` (or `cursor`) to keep the order across pages. |
| `term` | text |  | — | Free-text search term. |
| `state` | one of | live, successful | — | Limit to live campaigns or to successfully funded ones. Omit for Kickstarter's default mix. |
| `cursor` | text |  | — | `next_cursor` from a previous page (`seed:page`). Mutually exclusive with `page` and `seed`. Pattern: ^[0-9]{1,12}:[0-9]{1,3}$. |
| `raised` | number | 0 to 2 | — | Funding bucket: 0 = under 75% funded, 1 = 75%-100%, 2 = over 100%. |
| `woe_id` | number | 1 to … | — | Location WOE id from search_locations (e.g. 2357536 = Austin, TX). |
| `category_id` | number | 1 to … | — | Numeric category id from list_categories or a card's `category.id` (e.g. 34 = Tabletop Games, 12 = Games). |
| `recommended` | true or false |  | — | Only projects Kickstarter marks as recommended. |
| `staff_picks` | true or false |  | — | Only "Projects We Love". |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "kickstarter-com/crowdfunding-projects/search_projects",
    "input": {
      "tag": "<tag>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=kickstarter-com%2Fcrowdfunding-projects%2Fsearch_projects

## Common questions

### Kickstarter · Search projects

**How much does Kickstarter · Search projects cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Kickstarter · Search projects through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "kickstarter-com/crowdfunding-projects/search_projects"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Kickstarter · Search projects?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Kickstarter · Search projects?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

