---
name: orthogonal-search1api
description: "Call Search1API through Orthogonal's pay-per-use Run API: Live web access for AI agents: web and news search, agentic search (Ask), Google Maps places, page crawling, async site crawls, screenshots, sitemaps, trending feeds and schema-driven extraction behind one API."
---

# Search1API — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

Live web access for AI agents: web and news search, agentic search (Ask), Google Maps places, page crawling, async site crawls, screenshots, sitemaps, trending feeds and schema-driven extraction behind one API.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### Maps place search

Discover businesses and places with names, place IDs and public Maps links, plus addresses, contact details, ratings, review counts, coordinates and opening hours when available. Optional result fields are omitted when unavailable. Use POST /search for webpages and POST /crawl to read a business website.

Each request fetches one Google Maps page of up to 20 places. page is 1-based (1–6); page > 1 requires location coordinates. max_results only truncates that page and does not change the price or carry unused places into the next page. Send the same query, country, language and location with the next page number for another separately billed request. There is no automatic pagination, retry or filling from another engine. Results can change between requests; an empty or short page does not guarantee that no later results exist.

The response contains searchParameters and results, following the single-request format of POST /search and POST /news. searchParameters includes the requested

`POST /maps`

**Estimated cost:** $0.00327

**Page:** https://www.orthogonal.com/api/search1api/06d7d0ca-5e3f-497c-a247-bccf910602c7

**Docs:** https://s1.dev/docs/basic/maps

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Google Maps search phrase; leading and trailing whitespace is removed. |
| `country` | string | No | Two-letter country code, normalized to lowercase. Defaults to us. |
| `language` | string | No | Result language, for example en, de or zh-CN. Defaults to en. |
| `location` | object | No | Search origin coordinates and map zoom (default 14). Required for page > 1. Latitude must be -90 to 90, longitude -180 to 180, and zoom 3 to 30. Example: {"latitude":40.7455,"longitude":-74.0083,"zoom":15}. |
| `page` | integer | No | Page number, 1–6; default 1. Accepts an integer or canonical integer string such as "2". Empty strings use the default. Pages after the first require location. |
| `max_results` | integer | No | Maximum places to return from this page, 1–20; default 20. Accepts an integer or canonical integer string such as "10". Empty strings use the default. Truncation does not reduce the page charge or carry places to the next page. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/maps","body":{"query":"<string>","country":"<string>","language":"<string>","location":"<object>","page":"<integer>","max_results":"<integer>"}}'
```

### Webpage screenshot

Render a public webpage as a PNG, JPEG, or WebP image. Use it when appearance is the point — layout checks, visual previews, or content that does not survive text extraction — and control the viewport, when the page counts as ready, and whether to capture the full document or a single element by CSS selector. When you want the page's text instead, call POST /crawl. Costs 2 credits per request.

`POST /screenshot`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/search1api/b2580230-fe8a-40bc-9f26-2dbbffe278c7

**Docs:** https://s1.dev/docs/basic/screenshot

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes |  |
| `format` | string | No |  |
| `full_page` | boolean | No |  |
| `viewport` | object | No |  |
| `wait_until` | string | No |  |
| `wait_for_selector` | string | No |  |
| `selector` | string | No |  |
| `delay_ms` | integer | No |  |
| `timeout_ms` | integer | No |  |
| `quality` | integer | No |  |
| `omit_background` | boolean | No |  |
| `color_scheme` | string | No |  |
| `animations` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/screenshot","body":{"url":"<string>","format":"<string>","full_page":"<boolean>","viewport":"<object>","wait_until":"<string>","wait_for_selector":"<string>","selector":"<string>","delay_ms":"<integer>","timeout_ms":"<integer>","quality":"<integer>","omit_background":"<boolean>","color_scheme":"<string>","animations":"<string>"}}'
```

### Web search

Search the live public web when the answer depends on current information, sources, or research a model's training data cannot cover. Returns ranked results with id, title, URL, snippet, and `published_date` (ISO 8601, when the engine exposes one) across 13+ engines, with optional images. Set `crawl_results` to pull the top N result pages in the same call — each crawled page is billed as an additional crawl — or pass a result URL to POST /crawl separately. Costs 1 credit per request.

`POST /search`

**Estimated cost:** from $0.00109 per call (required params only), up to $0.05559; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/search1api/c304c062-01fd-4449-854c-1f89650fff46

**Docs:** https://s1.dev/docs/basic/search

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes |  |
| `search_service` | string | No |  |
| `max_results` | integer | No |  |
| `page` | integer | No |  |
| `crawl_results` | integer | No |  |
| `image` | boolean | No |  |
| `include_sites` | string | No |  |
| `exclude_sites` | string | No |  |
| `language` | string | No |  |
| `time_range` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/search","body":{"query":"<string>","search_service":"<string>","max_results":"<integer>","page":"<integer>","crawl_results":"<integer>","image":"<boolean>","include_sites":"<string>","exclude_sites":"<string>","language":"<string>","time_range":"<string>"}}'
```

### News search

Search recent news when the question is about events, announcements, or coverage rather than reference material. Returns articles from verified publishers with title, URL, snippet, `published_date` (ISO 8601, when known), and optional full page content, filterable by site, language, and time range. For questions that are not time-sensitive, prefer POST /search. Costs 1 credit per request.

`POST /news`

**Estimated cost:** from $0.00109 per call (required params only), up to $0.05559; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/search1api/1510d625-c987-44e9-aa42-679c61fb0a92

**Docs:** https://s1.dev/docs/basic/news

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes |  |
| `search_service` | string | No |  |
| `max_results` | integer | No |  |
| `crawl_results` | integer | No |  |
| `image` | boolean | No |  |
| `include_sites` | string | No |  |
| `exclude_sites` | string | No |  |
| `language` | string | No |  |
| `time_range` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/news","body":{"query":"<string>","search_service":"<string>","max_results":"<integer>","crawl_results":"<integer>","image":"<boolean>","include_sites":"<string>","exclude_sites":"<string>","language":"<string>","time_range":"<string>"}}'
```

### Agentic search

Agentic search. Describe what you are looking for in plain language and let a decision model (currently TypeSafe Jev) decide where to look. It picks up to five engines (web search, Hacker News, Reddit, GitHub, X, arXiv, Wikipedia, IMDb, WeChat, YouTube), rewrites the request into search keywords, infers a publication window from phrases such as "this week", searches the engines in parallel, and returns only the results judged relevant, merged and ranked, so agents read fewer off-topic results. The request takes only `query`; engines, keywords, and the window are always chosen by the model, and the response reports them in `intent`. Use POST /search instead when you already know the engine and keywords and want its raw ranking. Costs 5 credits per request.

`POST /ask`

**Estimated cost:** $0.00545

**Page:** https://www.orthogonal.com/api/search1api/4a158e58-0888-4cb9-ab0f-d2231fa6b775

**Docs:** https://s1.dev/docs/basic/ask

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | What you are looking for, in natural language. Platform hints ("on Reddit", "papers") and time hints ("this week") steer engine and time-range selection. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/ask","body":{"query":"<string>"}}'
```

### Page content crawl

Fetch one public URL and return its readable title and body as clean text, with navigation, boilerplate, and scripts stripped. Use it on a URL the user supplied or one returned by POST /search. To ingest a whole site rather than a single page, use POST /deepcrawl. Send an array of request objects to crawl several URLs in one call: the response is an array containing only the URLs that succeeded, in no guaranteed order, so match items back to your input by `crawlParameters.url`; failed URLs are omitted and not charged. `enable_fallback` is accepted as a snake_case alias of `enableFallback`. Costs 1 credit per request.

`POST /crawl`

**Estimated cost:** from $0.00109 per call (required params only), up to $0.0545; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/search1api/dd34cbf7-5bdd-4907-a2cd-0c769cff8eb3

**Docs:** https://s1.dev/docs/basic/crawl

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes |  |
| `enableFallback` | boolean | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/crawl","body":{"url":"<string>","enableFallback":"<boolean>"}}'
```

### Site URL discovery

Discover the public URLs of a site when you need to know which pages exist before fetching any of them — scoping a crawl, auditing coverage, or locating a section. With the default `type: "sitemap"` this reads the site's own sitemap: `Sitemap:` directives in robots.txt first, then the conventional paths, following sitemap index files and gzipped sitemaps, and returns the URLs it declares for the requested host. A site that publishes no sitemap falls back to the links found on the given page. Use `type: "all"` to skip the sitemap and get every link on that one page instead, including links to other hosts. Neither mode fetches page content. Costs 1 credit per request.

`POST /sitemap`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/search1api/47a3fe0f-babe-49be-8728-9fd4d570220e

**Docs:** https://s1.dev/docs/advanced/sitemap

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes |  |
| `type` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/sitemap","body":{"url":"<string>","type":"<string>"}}'
```

### Trending topics

List what is currently popular on a supported platform, such as GitHub repositories or Hacker News stories, when the user asks what is trending or new right now. This reads a platform's own live ranking rather than performing a query — for topic searches use POST /search. Costs 1 credit per request.

`POST /trending`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/search1api/fe3742de-e01a-4b13-be71-308fd7347957

**Docs:** https://s1.dev/docs/advanced/trending

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `search_service` | string | Yes |  |
| `max_results` | integer | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/trending","body":{"search_service":"<string>","max_results":"<integer>"}}'
```

### Structured data extraction

Pull structured data out of a single webpage using a natural-language prompt and a JSON schema you supply; both are required, and a request missing either returns 422 with the fields to fix. Use it when you need specific fields — prices, specifications, contact details — rather than the whole document; when you want the full text, use POST /crawl. Costs 10 credits per request.

`POST /extract`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/search1api/74ef2286-cc76-4060-8882-1c7d2661d98e

**Docs:** https://s1.dev/docs/advanced/extract

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The webpage to extract data from. |
| `prompt` | string | Yes | Natural-language instructions: what to extract from the page, e.g. "Extract the product name and price." |
| `response_format` | object | Yes | Shape of the result. Wrap your JSON Schema as {"type": "json_schema", "json_schema": <schema>}. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/extract","body":{"url":"<string>","prompt":"<string>","response_format":"<object>"}}'
```

### Site crawl start

Start an asynchronous crawl of an entire site and package the pages as documents. Use it for whole-site ingestion; a single page is POST /crawl. Narrow the crawl with include_paths/exclude_paths and cap it with max_pages; a task costs the same regardless of page count. Set format to "json" to get the pages inline in the status response instead of a ZIP. The call returns a task id immediately rather than the result — poll GET /deepcrawl/status/{taskId} until the task reports completion. Costs 20 credits per request.

`POST /deepcrawl`

**Estimated cost:** $0.0218

**Page:** https://www.orthogonal.com/api/search1api/26b9f6b4-9957-497c-bf61-9cb2d8f8de5c

**Docs:** https://s1.dev/docs/advanced/deepcrawl

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Absolute http or https URL to start from, e.g. https://example.com. A bare domain without the scheme is rejected with 400. |
| `type` | string | No |  |
| `max_pages` | integer | No | Maximum number of pages to crawl, 1–1000; default 1000. Applied after include_paths/exclude_paths, in discovery order. |
| `include_paths` | string | No | Only crawl URLs whose path matches one of these rules (up to 20). A rule without * is a path prefix on segment boundaries: "/docs" matches /docs and /docs/api but not /docsearch. A rule with * must match the whole path, and * matches any characters including /, e.g. "/blog/*". Empty or omitted means every discovered URL. |
| `exclude_paths` | string | No | Skip URLs whose path matches one of these rules (up to 20), using the same syntax as include_paths. Exclusion wins over inclusion. |
| `format` | string | No | Result format; default "zip". "zip" packages the pages as Markdown files behind zipUrl. "json" returns pages: [{url, title, content}] in the completed status response, plus resultUrl for the same JSON file. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/deepcrawl","body":{"url":"<string>","type":"<string>","max_pages":"<integer>","include_paths":"<string>","exclude_paths":"<string>","format":"<string>"}}'
```

### Site crawl status

Poll a deepcrawl task started by POST /deepcrawl. Returns the task's current state and, once it finishes, page counts (stats), failed URLs, and the result: zipUrl for format=zip, or the pages inline plus resultUrl for format=json. Safe to call repeatedly. Free to call.

`GET /deepcrawl/status/{taskId}`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/search1api/14c9677f-174b-404d-af15-59c642cbc995

**Docs:** https://s1.dev/docs/advanced/deepcrawl

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `taskId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {taskId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"search1api","path":"/deepcrawl/status/{taskId}","method":"GET"}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/search1api
