Home / Servers / OpenAI API / usage_web_search_calls

Web search calls

An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.

Web search calls Get web search calls usage details for the organization. [GET /organization/usage/web_search_calls]

Name on the gateway: openai_api__usage_web_search_calls · read-only.

Parameters

Name	Type	Description
`start_time` required	`integer`	Start time (Unix seconds) of the query time range, inclusive.
`end_time`	`integer`	End time (Unix seconds) of the query time range, exclusive.
`bucket_width`	`1m \| 1h \| 1d`	Width of each time bucket in response. Currently 1m, 1h and 1d are supported…
`project_ids`	`array`	Return only usage for these projects.
`user_ids`	`array`	Return only usage for these users.
`api_key_ids`	`array`	Return only usage for these API keys.
`models`	`array`	Return only usage for these models.
`context_levels`	`array`	Return only web search usage for these context levels.
`group_by`	`array`	Group the usage data by the specified fields. Support fields include…
`limit`	`integer`	Specifies the number of buckets to return. - bucket_width=1d: default: 7, max…
`page`	`string`	A cursor for use in pagination. Corresponding to the next_page field from the…

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments

{
  "name": "openai_api__usage_web_search_calls",
  "arguments": {
    "start_time": 0
  }
}

Or connect the OpenAI API server directly, which lists 371 tools including this one:

Run in your terminal

claude mcp add --transport http hj-openai-api https://mcp.hjlabs.in/mcp/openai-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Use the web search calls tool with start_time set to ….