Agenticfeed API

openapi: 3.1.0
info:
  title: Agenticfeed API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 6 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Agenticfeed has published no machine-readable contract that the
    pipeline could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 0
    documentation: 6
    pages-with-code: 1
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://agenticfeed.ai/api.html
  - https://agenticfeed.ai/docs.html
  - https://agenticfeed.ai/articles/agenticfeed-agent-query-api.html
paths:
  /.well-known/agent.json:
    get:
      operationId: get_well_known_agent_json
      tags:
      - API
      summary: Retrieve the well‑known agent card describing the agent's capabilities.
      description: Fetch the A2A‑compatible Agent Card in machine‑readable format.
      x-source: https://agenticfeed.ai/api.html
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/query:
    post:
      operationId: post_agent_query
      tags:
      - Agent
      summary: Send a POST request to /agent/query with your buyer's intent.
      description: Query ecommerce product data by natural language buyer intent.
      x-source: https://agenticfeed.ai/api.html
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAgentQueryRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAgentQueryResponse'
      x-evidence:
        kind: documentation
  /feed/{customer_guid}.json:
    get:
      operationId: get_feed_customer_guid_json
      tags:
      - Feed
      summary: Root feed – entry point identifying the merchant and providing URLs to all discovery feeds.
      description: The entry point. Identifies the merchant and provides URLs to all discovery feeds.
      x-source: https://agenticfeed.ai/docs.html
      parameters:
      - name: customer_guid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFeedCustomerGuidJsonResponse'
      x-evidence:
        kind: documentation
  /product/{customerGuid}/{product_guid}.json:
    get:
      operationId: get_product_customerGuid_product_guid_json
      tags:
      - Product
      summary: Product feed – full product detail for a given product GUID.
      description: The terminal node of the chain. Contains the full product detail an AI agent needs to make a confident recommendation or purchase.
      x-source: https://agenticfeed.ai/docs.html
      parameters:
      - name: customerGuid
        in: path
        required: true
        schema:
          type: string
      - name: product_guid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetProductCustomerguidProductGuidJsonResponse'
      x-evidence:
        kind: documentation
  /questions/{customer_guid}.json:
    get:
      operationId: get_questions_customer_guid_json
      tags:
      - Questions
      summary: Category index for questions – lists categories with URLs and counts.
      description: Category index for questions discovery feed.
      x-source: https://agenticfeed.ai/docs.html
      parameters:
      - name: customer_guid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetQuestionsCustomerGuidJsonResponse'
      x-evidence:
        kind: documentation
  /questions/{customerGuid}/{category}.json:
    get:
      operationId: get_questions_customerGuid_category_json
      tags:
      - Questions
      summary: Category detail for questions – lists individual questions with product links.
      description: Category detail page listing individual entries with links to matching products.
      x-source: https://agenticfeed.ai/docs.html
      parameters:
      - name: customerGuid
        in: path
        required: true
        schema:
          type: string
      - name: category
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetQuestionsCustomerguidCategoryJsonResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostAgentQueryRequest:
      type: object
      properties:
        query:
          type: string
          description: Natural language description of what the buyer needs. The more specific, the better the matches.
        customer_guid:
          type: string
          description: The merchant feed to query. Defaults to the feed linked to your Agenticfeed API key if omitted.
        limit:
          type: integer
          description: Maximum products to return. Between 1 and 10. Default is 5.
      required:
      - query
    PostAgentQueryResponse:
      type: object
      properties:
        '@context':
          type: string
          description: JSON‑LD context URL.
        '@type':
          type: string
          description: Schema.org type, typically "ItemList".
        query:
          type: string
          description: The original query string.
        numberOfItems:
          type: integer
          description: Number of product items returned.
        itemListElement:
          type: array
          description: Array of matched Product entries, each containing product details and a match_reason.
    GetFeedCustomerGuidJsonResponse:
      type: object
      properties:
        service:
          type: string
        version:
          type: string
        dateModified:
          type: string
        merchant:
          type: string
        purpose:
          type: string
        discovery:
          type: object
        resolution:
          type: object
    GetProductCustomerguidProductGuidJsonResponse:
      type: object
      properties:
        service:
          type: string
        version:
          type: string
        dateModified:
          type: string
        purpose:
          type: string
        product_id:
          type: string
        title:
          type: string
        category:
          type: string
        primary_img_url:
          type: string
        problems:
          type: array
        questions:
          type: array
        use_cases:
          type: array
        merchant_url:
          type: string
    GetQuestionsCustomerGuidJsonResponse:
      type: object
      properties:
        service:
          type: string
        version:
          type: string
        dateModified:
          type: string
        categories:
          type: array
    GetQuestionsCustomerguidCategoryJsonResponse:
      type: object
      properties:
        service:
          type: string
        version:
          type: string
        dateModified:
          type: string
        customer:
          type: string
        category:
          type: string
        questions:
          type: array
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: API
- name: Agent
- name: Feed
- name: Product
- name: Questions