# import.io API

> import.io API on Apizie: 2 endpoints (Cancel an existing crawl., Launch a crawl from an extractor that a user owns.) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/web-tools:import-run/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `web-tools:import-run`
- Category: Web Tools
- Status: byok
- Source: https://import.io
- Page: https://zieapi.vercel.app/api/web-tools/import-run
- OpenAPI: https://zieapi.vercel.app/api/web-tools/import-run/openapi.json



## Endpoints

### Cancel an existing crawl.
`POST https://zieapi.vercel.app/v1/web-tools:import-run/post-extractor-extractor-id-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| extractorId | string | yes | extractorId |

### Launch a crawl from an extractor that a user owns.
`POST https://zieapi.vercel.app/v1/web-tools:import-run/post-extractor-extractor-id-start` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| extractorId | string | yes | the id of the extractor to start crawling with |

## Example
```
curl "https://zieapi.vercel.app/v1/web-tools:import-run/post-extractor-extractor-id-cancel" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the import.io API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/web-tools:import-run/post-extractor-extractor-id-cancel with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the import.io API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. import.io itself also needs your own key from import.io.

### Can AI agents use the import.io API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key web-tools:import-run.

### What is the status of the import.io API?
Needs your own provider key (bring your own key)