Vercel

Use Parallel with Vercel

For AI agents: a documentation index is available at https://docs.parallel.ai/llms.txt. The full text of all docs is at https://docs.parallel.ai/llms-full.txt. You may also fetch any page as Markdown by appending .md to its URL or sending Accept: text/markdown.

Use Parallel through Vercel AI Gateway, the Vercel AI SDK, or the Vercel Marketplace.

Vercel AI Gateway

Parallel Search is available as a built-in tool in Vercel AI Gateway. AI Gateway provides a unified API to access hundreds of models through a single endpoint, with built-in web search capabilities.

The parallelSearch tool can be used with any model regardless of the model provider. When the model needs current information, it calls the tool and AI Gateway routes the request to Parallel’s Search API.

For local development, install the AI SDK and configure an AI Gateway API key:

npm install ai
export AI_GATEWAY_API_KEY="your-ai-gateway-api-key"

Vercel deployments can use OIDC authentication instead of an API key.

streamText

import { gateway, streamText } from 'ai';

export async function POST(request: Request) {
  const { prompt } = await request.json();

  const result = streamText({
    model: 'anthropic/claude-sonnet-4.5', // Works with any model
    prompt,
    tools: {
      parallel_search: gateway.tools.parallelSearch(),
    },
  });

  return result.toUIMessageStreamResponse();
}

You can configure Gateway options such as maxResults, sourcePolicy, excerpts, and fetchPolicy. Gateway search modes differ from the direct Parallel Search API modes. See the Parallel parameters documentation for all Gateway options.

Vercel AI SDK

Easily drop in Parallel Search API or Extract API with any Vercel AI SDK compatible model provider.

• Search API: Given the required search_queries and optional objective, Parallel returns ranked URLs with compressed excerpts
• Extract API: Given a URL and an optional objective, Parallel returns compressed excerpts or full page contents

Install AI SDK v6, the OpenAI provider, and version 1 of Parallel’s tool package:

npm install ai@^6 @ai-sdk/openai@^3 @parallel-web/ai-sdk-tools@^1
export PARALLEL_API_KEY="your-parallel-api-key"
export OPENAI_API_KEY="your-openai-api-key"

The direct Search API supports the turbo, fast, basic, and advanced search modes. In @parallel-web/ai-sdk-tools@^1, searchTool supports basic and advanced and defaults to advanced. The agentic and one-shot tool modes belong to older package versions.

Links:

• NPM Package
• Vercel AI SDK Toolkit
• Vercel AI SDK Web Search Agent Cookbook

Sample Code

Parallel search and extract tools can be used with any Vercel AI SDK compatible model provider.

Search

import { openai } from '@ai-sdk/openai';
import { stepCountIs, streamText } from 'ai';
import { searchTool } from '@parallel-web/ai-sdk-tools';

export async function POST() {
  const result = streamText({
    model: openai('gpt-5'),
    prompt: 'What are the latest developments in AI?',
    tools: {
      'web-search': searchTool,
    },
    stopWhen: stepCountIs(3),
  });

  return result.toUIMessageStreamResponse();
}

Vercel Marketplace

Parallel is available on the Vercel Marketplace. Install the integration to get a Parallel API key that you can use directly in your Vercel apps, with billing managed through Vercel.

Getting started

1. Install the Parallel integration from the Vercel Marketplace
2. Once installed, you’ll receive a Parallel API key automatically provisioned for your account
3. Use the API key in your Vercel applications to access Parallel Search and Extract APIs

Example application

See the Parallel Vercel Template for a working example, with source code available in the cookbook repository.