# Search Services API

> Search Services API on Apizie: 3 endpoints (Fields that can be requested, Return relevance-based results from search queries, Scrape search results from Internet Archive, allowing a scrolling cursor) returned as clean JSON through one API key. 3 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/search-tools:archive-search/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `search-tools:archive-search`
- Category: Search Tools
- Status: live
- Source: https://archive.org
- Page: https://zieapi.vercel.app/api/search-tools/archive-search
- OpenAPI: https://zieapi.vercel.app/api/search-tools/archive-search/openapi.json

API for Internet Archive's Search-related services

## Endpoints

### Fields that can be requested
`GET https://zieapi.vercel.app/v1/search-tools:archive-search/get-search-v1-fields`

| Parameter | Type | Required | Description |
|---|---|---|---|
| callback | string | no | Specifies a JavaScript function func, for a JSON-P response. When provided, results are wrapped as `callback(data)`, and the returned MIME… |

### Return relevance-based results from search queries
`GET https://zieapi.vercel.app/v1/search-tools:archive-search/get-search-v1-organic`

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | no | Lucene-type search query |
| field | string | no | Metadata field |
| size | integer | no | Number of query results to return |
| total_only | boolean | no | Request total only; do not return hits |
| callback | string | no | Specifies a JavaScript function func, for a JSON-P response. When provided, results are wrapped as `callback(data)`, and the returned MIME… |

### Scrape search results from Internet Archive, allowing a scrolling cursor
`GET https://zieapi.vercel.app/v1/search-tools:archive-search/get-search-v1-scrape`

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | no | Lucene-type search query |
| field | string | no | Metadata field |
| sort | string | no | sort collations |
| size | integer | no | Number of query results to return |
| cursor | string | no | Cursor for scrolling (used for subsequent calls) |
| total_only | boolean | no | Request total only; do not return hits |
| callback | string | no | Specifies a JavaScript function func, for a JSON-P response. When provided, results are wrapped as `callback(data)`, and the returned MIME… |

## Example
```
curl "https://zieapi.vercel.app/v1/search-tools:archive-search/get-search-v1-fields" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Search Services API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/search-tools:archive-search/get-search-v1-fields with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Search Services API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Search Services 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 search-tools:archive-search.

### What is the status of the Search Services API?
Live: works with just an Apizie key
