Field notes

What coding agents need from Search API results

Titles and URLs are not enough. Coding agents need source rank, snippets, dates, stable shapes, and errors they can evaluate.

Search quality is often discussed as if relevance were a single number. For a coding agent, useful retrieval is a chain of smaller requirements: find the right source, preserve enough context, expose freshness, and return a shape that downstream code can trust.

Our first Search API Agent Bench release normalizes every provider response to four fields: title, URL, snippet, and publication date. The normalization is deliberately plain. It makes the output comparable without pretending the underlying products work identically.

Put primary sources where the agent can use them

For technical questions, the expected answer often lives in official documentation or a maintained repository. A search result that ranks a derivative article above the canonical source adds verification work and can introduce stale details.

Our current retrieval protocol therefore checks the rank of an expected primary domain. The first release used Node.js, GitHub, and PostgreSQL questions with explicit first-party sources. Exa, Perplexity Search, and Parallel Search placed the expected source first in all 27 attempts.

That result is narrower than “perfect relevance.” It means the primary source was easy for the next step to inspect.

Snippets should support triage, not replace the source

A snippet helps an agent decide which pages deserve a follow-up request. Empty or generic snippets force it to fetch more pages, increasing latency, cost, and the number of places a workflow can fail.

At the same time, snippets are not authoritative answers. They may be truncated, assembled from surrounding text, or detached from page context. The agent should retain the result URL and verify consequential claims against the source.

Our current pass rule requires snippet coverage on at least 80% of results. All three tested providers returned 100% snippet coverage in the published run.

Dates are task-dependent evidence

Publication dates matter for releases, pricing, policy, incidents, and changing product capabilities. They matter less for a stable reference page whose current content is maintained in place.

This makes date coverage a reported metric rather than a universal pass condition. In our run, Perplexity Search returned dates on 100% of normalized results, Parallel Search on 49%, and Exa on 33%.

The right choice depends on the workload. A news-monitoring agent may value complete dates more than a documentation lookup tool does.

Stable response shapes reduce corrective work

An agent should not need provider-specific guesswork to identify the title, destination, excerpt, or publication time. Typed SDKs and published schemas can help, but the runtime response still needs predictable fields and documented null behavior.

For comparison, our artifact pipeline preserves both the provider run and the normalized result. That lets a reader inspect what the benchmark evaluated without exposing credentials or private account identifiers.

Errors and limits belong in the result story

A successful demo request is not the whole integration. Search APIs can vary by rate limit, billing state, query length, requested result count, geography, and endpoint mode.

Reports should record the timeout, warning state, failed attempts, and observed cost alongside successful outputs. Otherwise a benchmark rewards the result while hiding the conditions required to produce it.

A practical evaluation order

When comparing Search APIs for an agent workflow, inspect them in this order:

  1. Can the API consistently surface the expected primary source?
  2. Do snippets contain enough context to choose a follow-up page?
  3. Does the response preserve dates when freshness matters?
  4. Are result fields stable and documented?
  5. Are errors, limits, and costs visible enough for the agent to recover safely?

Latency matters, but it comes after correctness and evaluability. A fast response that sends the workflow to the wrong source only reaches the wrong answer sooner.

The provider-level Exa, Perplexity Search, and Parallel Search reports publish the exact queries, representative ranked outputs, all measured attempts, and the command used to reproduce the benchmark.