Skip to content

Docs / All tools / Base tools

web.search

Search the web and return titles, URLs, and snippets.

2 credits. Per search. 0 when there is no result.

Example prompt

Send this to your AI app when Heelo is connected:

Find recent benchmarks for open source coding agents

Input fields

FieldTypeDescription
queryRequiredstringNatural-language web search query

Output fields

The fields in data when status is success.

FieldType
resultsarray of object
total_foundinteger
search_querystring
time_filterstring
search_providerstring
search_coverageobject

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/web.search/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "query": "Find recent benchmarks for open source coding agents",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())