Skip to content

Agenticfeed Standard v0.2.0 — Agent Query API

Choose a tag to compare

View all tags
@bluestratus bluestratus released this 09 Jun 08:27
· 2 commits to main since this release
v0.2.0
642c5d3

Agenticfeed Standard v0.2.0

This release adds the Agent Query API — an active layer that lets AI agents query product data by natural language buyer intent, on top of the passive feed discovery introduced in v0.1.0.

What's new

Agent Query API

  • POST /agent/query endpoint accepts a natural language buyer intent and returns a ranked schema.org ItemList of matched products
  • Each result includes a match_reason field explaining why the product fits the buyer's need — designed to be passed directly to the buyer by the calling agent
  • Matching is performed by Claude Haiku

Bring your own Anthropic key

  • Callers supply their own Anthropic API key in the request body as anthropic_api_key
  • The key is validated with a minimal one-token call before any product data is fetched
  • Callers pay Anthropic directly at standard rates — the feed provider pays nothing for AI compute

A2A-compatible Agent Card

  • Agent Card published at /.well-known/agent.json
  • Describes capabilities, accepted inputs, output format, and authentication in machine-readable format
  • Compatible with Google's Agent-to-Agent (A2A) protocol for automatic agent discovery

Attribution

  • All product URLs in query responses are UTM-tagged (utm_source=agenticfeed&utm_medium=ai-agent)
  • Merchants can measure AI agent-driven revenue in their existing analytics

Reference implementation

agenticfeed.ai — includes the query endpoint, Agent Card, and developer documentation at agenticfeed.ai/api.html

Assets 2
Loading