Openperplex API provides powerful, global search capabilities and web content analysis for AI applications.
Openperplex API provides powerful, global search capabilities and web content analysis for AI applications. On Nagent, Openperplex is exposed as a fully-configurable artificial intelligence integration that any agent can call — 8 actions, and API key authentication. No code is required to wire Openperplex into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Openperplex to automate the kinds of tasks artificial intelligence teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Openperplex into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Openperplex, with input parameters and output schema. Drop these into any step of an agent built in Helix.
OPENPERPLEX_CUSTOM_SEARCHTool to perform a custom search with optional filtering and field selection. Use when you need tailored results based on query, filters, size, or fields.
Input parameters
Number of desired results (must be ≥ 1).
The search query string.
Filters to apply on the search results.
User prompt for guiding the search.
System prompt for guiding the search.
Fields to exclude from results.
Fields to include in results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
OPENPERPLEX_CUSTOM_SEARCH_STREAMTool to perform custom streaming search with custom prompts. Use when you need AI-powered search responses with custom system and user prompts for more specific or tailored queries. Returns aggregated text response along with optional sources and images.
Input parameters
Model to use for the search. Options: 'gpt-4o-mini' (default), 'gpt-4o', 'o3-mini-high', 'o3-mini-medium', 'gemini-2.0-flash'.
Top-p for output diversity (0.0-1.0, default 0.9).
Two-letter country code for localized results, e.g., 'us', 'uk', 'fr', 'de', 'jp'.
Type of search: 'general' or 'news'.
Temperature for output randomness (0.0-1.0 exclusive, default 0.2).
User prompt specifying the search query. Be specific as this is used for web search.
Whether to include images in the response.
System prompt defining assistant behavior and response format.
Filter results by recency: 'hour', 'day', 'week', 'month', 'year', or 'anytime'.
Whether to include sources in the response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
OPENPERPLEX_GET_WEBSITE_MARKDOWNTool to retrieve the markdown content of a specified website. Use after confirming the URL. Supports optional formats like 'gfm' or 'commonmark'.
Input parameters
The full URL of the website to fetch and convert to markdown
The target markdown standard/format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
OPENPERPLEX_GET_WEBSITE_SCREENSHOTTool to capture a screenshot of a website. Use after confirming the target URL is reachable.
Input parameters
The website URL to capture.
Whether to capture the entire scrollable page.
Width of the browser viewport in pixels.
Height of the browser viewport in pixels.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
OPENPERPLEX_GET_WEBSITE_TEXTTool to retrieve the main text content of a specified website URL. Use when you need content extraction from online articles or pages. Use after confirming the URL is publicly accessible.
Input parameters
The URL of the web page to extract text from.
If true, returns cleaner and more concise text.
Maximum number of characters to extract.
Format of the returned text: 'plain', 'html', or 'markdown'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
OPENPERPLEX_QUERY_FROM_URLTool to query documents from a URL. Use when you need to fetch and interrogate web-hosted content with a natural language question.
Input parameters
The URL of the website you want to interact with.
LLM model to use. Options: o3-mini-high, o3-mini-medium, gpt-4o, gpt-4o-mini, gemini-2.0-flash. Default is gpt-4o-mini.
The question you want to ask about the content at the URL.
Format of the answer. Options: 'text', 'markdown', or 'html'. Default is 'text'.
Language code for the response. 'auto' will auto-detect based on the query. Supported: auto, en, fr, es, de, it, pt, nl, ja, ko, zh, ar, ru, tr, hi.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
OPENPERPLEX_SEARCHTool to search documents using query parameters. Use when you have a search query and optional filters ready.
Input parameters
Model to use for generating responses. Options: 'o3-mini-high', 'o3-mini-medium', 'gpt-4o', 'gpt-4o-mini', 'gemini-2.0-flash'.
The search query or question you want to ask. This is the primary input for your search.
Country code for localized search results (e.g., 'us', 'jp', 'br', 'fr').
Format of the answer. Options: 'text', 'markdown', or 'html'.
Type of search to perform. Options: 'general' or 'news'.
Optional date for context. Format example: 'Today is Monday 16 of September 2024 and the time is 6:36 PM'. If not provided, the API uses the current date of the server.
Set to True to include images in the result.
Filter results by recency. Options: 'hour', 'day', 'week', 'month', 'year', 'anytime'.
Set to True to include sources in the result.
Set to True to include citations in the response.
Language code for the response. Use 'auto' to auto-detect based on the query.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
OPENPERPLEX_SEARCH_STREAMTool to stream search results from OpenPerplex. Use when real-time AI-powered search responses are needed. Returns aggregated text response along with optional sources, images, and citations.
Input parameters
Model to use for the search. Options: 'gpt-4o-mini' (default), 'gpt-4o', 'o3-mini-high', 'o3-mini-medium', 'gemini-2.0-flash'.
Search query string.
Two-letter country code for localized results, e.g., 'us', 'uk', 'fr', 'de', 'jp'.
Format of the answer: 'text', 'markdown', or 'html'.
Type of search: 'general' or 'news'.
Optional date context string, e.g., 'Today is Monday 16 of September 2024 and the time is 6:36 PM'. Uses server date if not provided.
Whether to include images in the response.
Filter results by recency: 'hour', 'day', 'week', 'month', 'year', or 'anytime'.
Whether to include sources in the response.
Whether to include citations in the response.
Language code for response. 'auto' auto-detects based on query. Options: en, fr, es, de, it, pt, nl, ja, ko, zh, ar, ru, tr, hi.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 52 agents privately built on Nagent that already use Openperplex.
Build on Nagent
Connect Openperplex to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Openperplex, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Openperplex is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Openperplex is connected, you configure its 8 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Openperplex steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Openperplex event fires, the agent kicks off automatically.
Every Openperplex action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Openperplex ships with 8 pre-built artificial intelligence actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Openperplex together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Openperplex-based workflows tailored to your business.