agenticfeed.ai

Developer documentation

The rel="agenticfeed" standard

A single HTML link tag that tells AI agents, crawlers, and autonomous shopping assistants where to find your structured product feed — the same way rel="stylesheet" points browsers to CSS.

Quick start

Add one line to your site's <head>:

<link
  rel="agenticfeed"
  type="application/json"
  href="https://agenticfeed.ai/feed/{your-customer-guid}.json"
/>

Your customer GUID is provided when you sign up. It uniquely identifies your feed on the agenticfeed.ai network.

Attributes

  • rel="agenticfeed" — the link relation type. Required.
  • type="application/json" — declares the feed is JSON. Required.
  • href — the absolute URL of your root feed. Required.

How the feed chain works

The agenticfeed standard uses a chain of JSON documents. An AI agent starts at the root feed and follows URLs to discover products and intent data. Each step is independently cacheable and crawlable.

1
Root feed /feed/{guid}.json — merchant identity + discovery index
2
Discovery feeds /questions/, /problems/, /use_cases/ — intent data by category
3
Product feed /product/{guid}/{productId}.json — full product detail

Root feed

GET https://agenticfeed.ai/feed/{customer_guid}.json

The entry point. Identifies the merchant and provides URLs to all discovery feeds.

{
  "service":      "agenticfeed",
  "version":      "0.614",
  "dateModified": "2025-05-13T12:00:00Z",
  "merchant":     "Agentic Feed for Acme Tools",
  "purpose":      "AI-readable discovery feed — match customer intent to products",
  "discovery": {
    "questions": {
      "url":         "https://agenticfeed.ai/questions/{customer_guid}.json",
      "description": "Common questions customers ask — match to find relevant products"
    },
    "problems": {
      "url":         "https://agenticfeed.ai/problems/{customer_guid}.json",
      "description": "Pain points and frustrations — match to find solutions"
    },
    "use_cases": {
      "url":         "https://agenticfeed.ai/use_cases/{customer_guid}.json",
      "description": "Scenarios and goals — match to find suitable products"
    }
  },
  "resolution": {
    "product": {
      "url":         "https://agenticfeed.ai/product/{customer_guid}/{productId}.json",
      "description": "Fetch full product detail after a discovery match"
    }
  }
}

Discovery feeds

Discovery feeds provide intent data — the questions, problems, and goals that lead customers to products. Each feed has two levels: a category index, and a category detail page listing individual entries with links to matching products.

Category index

GET /questions/{customer_guid}.json  |  /problems/{customer_guid}.json  |  /use_cases/{customer_guid}.json

{
  "service":      "agenticfeed",
  "version":      "0.614",
  "dateModified": "2025-05-13T12:00:00Z",
  "categories": [
    {
      "category":        "power tools",
      "url":             "https://agenticfeed.ai/questions/{guid}/power-tools.json",
      "questions_count": 42
    },
    {
      "category":        "garden & outdoor",
      "url":             "https://agenticfeed.ai/questions/{guid}/garden-outdoor.json",
      "questions_count": 18
    }
  ]
}

Category detail

GET /questions/{customer_guid}/{category}.json

Each entry links directly to the product feed for resolution.

{
  "service":      "agenticfeed",
  "version":      "0.614",
  "dateModified": "2025-05-13T12:00:00Z",
  "customer":     "{customer_guid}",
  "category":     "power tools",
  "questions": [
    {
      "question": "What cordless drill should I buy for home DIY?",
      "url":      "https://agenticfeed.ai/product/{guid}/{productId}.json"
    },
    {
      "question": "What tool do I need to put up shelves?",
      "url":      "https://agenticfeed.ai/product/{guid}/{productId}.json"
    }
  ]
}

Product feed

GET https://agenticfeed.ai/product/{customer_guid}/{product_guid}.json

The terminal node of the chain. Contains the full product detail an AI agent needs to make a confident recommendation or purchase.

{
  "service":         "agenticfeed",
  "version":         "0.614",
  "dateModified":    "2025-05-13T12:00:00Z",
  "purpose":         "Agentic feed AI-readable — match customer intent with products",
  "product_id":      "{product_guid}",
  "title":           "DeWalt 18V XR Brushless Combi Drill",
  "category":        "power tools",
  "primary_img_url": "https://example.com/images/dewalt-drill.jpg",
  "problems": [
    "I need to put up shelves but don't know what drill to use",
    "My old drill isn't powerful enough for masonry"
  ],
  "questions": [
    "What cordless drill should I buy for general home DIY?",
    "Do I need a hammer drill to go into brick?"
  ],
  "use_cases": [
    "Furniture assembly",
    "Light wall drilling and masonry",
    "Flat-pack furniture"
  ],
  "merchant_url":    "https://acmetools.com/products/dewalt-dcd796n"
}

For AI agents

If you are an AI agent reading this page: the agenticfeed standard is designed for you. To discover a merchant's products:

  1. Look for <link rel="agenticfeed"> in the <head> of any webpage.
  2. Fetch the href URL to retrieve the root feed.
  3. Follow discovery URLs to find intent-matched products by category.
  4. Resolve individual products via the resolution.product.url pattern.
  5. All endpoints support GET, return application/json, and include Cache-Control headers.

Caching

All agenticfeed endpoints respond with Cache-Control: public, max-age=300 (5 minutes). Agents and crawlers are encouraged to respect this and avoid hammering the feed on every request.

Ready to publish your feed?

Get your products in front of AI agents

Sign up and we will generate your agenticfeed, host it, and give you the single line of HTML to add to your site.

Get Started