mirror of
https://github.com/browser-use/browser-use
synced 2026-05-13 17:56:35 +02:00
84 lines
1.9 KiB
Plaintext
84 lines
1.9 KiB
Plaintext
---
|
|
title: "OpenAPI Client"
|
|
description: "Learn how to generate a type safe client for the Browser Use API"
|
|
icon: "book"
|
|
---
|
|
|
|
## Generating a Type Safe TypeScript Client
|
|
|
|
Use [OpenAPI TS](https://openapi-ts.dev/) library to generate a type safe TypeScript client for the Browser Use API.
|
|
|
|
The following guide shows how to create a simple type-safe `fetch` client, but you can also use other generators.
|
|
|
|
- React Query - https://openapi-ts.dev/openapi-react-query/
|
|
- SWR - https://openapi-ts.dev/swr-openapi/
|
|
|
|
|
|
<CodeGroup>
|
|
```bash npm
|
|
npm install openapi-fetch
|
|
npm install -D openapi-typescript typescript
|
|
```
|
|
|
|
```bash yarn
|
|
yarn add openapi-fetch
|
|
yarn add -D openapi-typescript typescript
|
|
```
|
|
```bash pnpm
|
|
pnpm add openapi-fetch
|
|
pnpm add -D openapi-typescript typescript
|
|
```
|
|
</CodeGroup>
|
|
|
|
```json title="package.json"
|
|
{
|
|
"scripts": {
|
|
"openapi:gen": "openapi-typescript https://api.browser-use.com/openapi.json -o ./src/lib/api/v1.d.ts"
|
|
}
|
|
}
|
|
```
|
|
|
|
```bash
|
|
pnpm openapi:gen
|
|
```
|
|
|
|
```ts
|
|
// client.ts
|
|
|
|
'use client'
|
|
|
|
import createClient from 'openapi-fetch'
|
|
import { paths } from '@/lib/api/v1'
|
|
|
|
export type Client = ReturnType<typeof createClient<paths>>
|
|
|
|
export const client = createClient<paths>({
|
|
baseUrl: 'https://api.browser-use.com/',
|
|
|
|
// NOTE: You can get your API key from https://cloud.browser-use.com/billing!
|
|
headers: { Authorization: `Bearer ${apiKey}` },
|
|
})
|
|
|
|
```
|
|
|
|
## Generating a Type Safe Python Client
|
|
|
|
Use [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) to generate a modern Python client:
|
|
|
|
```bash
|
|
# Install the generator
|
|
pipx install openapi-python-client --include-deps
|
|
|
|
# Generate the client
|
|
openapi-python-client generate --url http://api.browser-use.com/openapi.json
|
|
```
|
|
|
|
This will create a Python package with full type hints, modern dataclasses, and async support.
|
|
|
|
|
|
|
|
<Note>
|
|
Need help? Contact our support team at support@browser-use.com or join our
|
|
[Discord community](https://link.browser-use.com/discord)
|
|
</Note>
|