---
title: "Search api integration for LuumenAI"
url: "https://www.luumen.ai/integrations/search-api/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Search api integration for LuumenAI

Run web searches from the terminal and read the results as JSON

## What LuumenAI can do with Search api

LuumenAI connects to Search api with an API token and exposes 5 tools (5 read-only). Every tool is read-only, so it can answer questions from Search api but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 5 tools (5 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Source control & CI/CD

## About Search api with LuumenAI

Ask Search api a question mid-incident and get an answer back in the terminal. SEARCH_API_SEARCH queries across engines like Google, Bing, and YouTube; SEARCH_API_GET_LOCATIONS narrows a query to a region. Pull a prior result again with SEARCH_API_GET_CACHED_SEARCH_BY_ID or its HTML form, and check credits with SEARCH_API_GET_ACCOUNT_INFO. Connect with an API key. Every tool here is read-only.

## Example tools

Read-only (5 in total):

- `SEARCH_API_GET_ACCOUNT_INFO` — Retrieve account usage statistics including monthly usage, remaining credits, hourly limits, and subscription period information.
- `SEARCH_API_GET_CACHED_SEARCH_BY_ID` — Retrieve cached search results by search ID in JSON format.
- `SEARCH_API_GET_CACHED_SEARCH_HTML_BY_ID` — Retrieve cached search results by search ID in HTML format.
- `SEARCH_API_GET_LOCATIONS` — Get available locations for geo-localized search queries.
- `SEARCH_API_SEARCH` — Perform unified search across 40+ search engines including Google, Bing, Yahoo, DuckDuckGo, YouTube, Amazon, and more.

## Frequently asked questions

### How does LuumenAI connect to Search api?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Search api on its own?

No. Every one of the 5 tools is read-only, so LuumenAI can answer questions from Search api but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to Search api is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/search-api/