🌐GlobalPOST /v1/global/web-search

Croma Web Search

Web search with highlighted summaries and structured metadata (URL, title, author, date). Built to feed AI agents with fresh context.

Tomás Calle

Founder · Croma

This is a public demo with a reduced rate limit. For a production API key, book a call. I get back the same day.

tomas@usecroma.com+57 317 512 6894

Book 15 min

Integration guide

Source: Web search provider integrated by Croma.
Freshness: On-demand web lookup; freshness depends on the pages found.
Latency: Usually seconds; capped at 10 searches per hour.
Auth: Bearer API key in the Authorization header.

Best for

Feed AI agents with fresh web context.
Pull URLs, titles, dates, authors and highlights.
Build research flows with structured results.

Request fields

querystringreq: Search query, 3–300 characters.
limitnumber: Number of results, between 1 and 25. Defaults to 10.

Response fields

resultsarray: Results ordered by relevance.
results[].urlstring: Canonical URL of the result.
results[].titlestring: Detected title of the result.
results[].published_datestring: Publication date if available.
results[].authorstring: Author reported if available.
results[].highlightsarray: Highlighted snippets relevant to the query.
results[].scorenumber: Relevance score for the result.

Frequently asked

What does Croma Web Search return?

Structured web results with URL, title, author, published date, highlights and a relevance score.

What is the rate limit for Web Search?

The endpoint is capped at 10 searches per hour because it relies on a paid upstream that's sensitive to abuse.

Try it

Result

Edit the JSON and submit to see results with summaries.

Reference

curl https://api.usecroma.com/v1/global/web-search \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"croma api colombia","limit":10}'