Agentic Platform
Documentation API reference Tools Skills

Tools

SearchGPT

searchgpt MCP Web search

Search the web and get AI-powered answers with citations.

Use GPT with web browsing capabilities to search the internet and provide accurate, up-to-date answers to your questions. Perfect for research, fact-checking, and getting comprehensive information about any topic.

Playground

Your organization, project and token stay in this browser's local storage and are sent straight to the API — this page never sees them.

POST
item
question required What would you like to search for?
city The city to search for
country The country to search for. ISO 3166-1 alpha-2 country code, e.g. "US".
config
model OpenAI model to use for search

Billing

Fixed cost per question asked, plus one AI web search (OpenAI) per query and the model usage for reading the results and writing the answer. The search fee dominates a short answer; a long one is driven by the answer written.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item, on top of any usage below.
AI web search (OpenAI) 10 per query The same, through OpenAI's built-in web search. Billed on top of the model's own usage.
GPT-5 mini (flex), input 125 per million tokens Tokens the model reads from the prompt you send.
GPT-5 mini (flex), output 1,000 per million tokens Tokens the model writes in its answer.
GPT-5 mini (flex), read from cache 12.5 per million tokens Tokens the model reads from a cached prompt. Cheaper than a fresh read.
GPT-5 mini (standard), input 250 per million tokens Tokens the model reads from the prompt you send.
GPT-5 mini (standard), output 2,000 per million tokens Tokens the model writes in its answer.
GPT-5 mini (standard), read from cache 25 per million tokens Tokens the model reads from a cached prompt. Cheaper than a fresh read.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
question string required

What would you like to search for?

city string

The city to search for

Default: ""

country string

The country to search for. ISO 3166-1 alpha-2 country code, e.g. "US".

Default: ""

Example
{
  "question": "string",
  "city": "",
  "country": ""
}

Configuration

object
Properties
model string

OpenAI model to use for search

Default: "gpt-5-mini"

Example
{
  "model": "gpt-5-mini"
}

Response

object
Properties
model string required

Model used for the search

answer string required

AI-powered answer to the search query

links array required

List of source links with titles, URLs and positions

Items: SearchGptLink

Example
{
  "model": "string",
  "answer": "string",
  "links": [
    {
      "url": "string",
      "title": "string",
      "position": 0
    }
  ]
}

Type Definitions

1 type

These are the available sub-object types that can be used in the properties above.

Endpoints

POST http://agents.botify.com/{organization}/{project}/searchgpt/process
POST http://agents.botify.com/{organization}/{project}/searchgpt/batch_process
POST http://agents.botify.com/{organization}/{project}/searchgpt/async_process
POST http://agents.botify.com/{organization}/{project}/searchgpt/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/searchgpt/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "question": "<question>"
  }
}'

Over MCP

This tool is exposed as the MCP tool searchgpt. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata