agenteconomy.cloud Pricing API

openapi: 3.2.0
info:
  title: Agentery Market Intelligence Pricing API
  version: 1.27.0
  summary: Free, keyless REST access to Agentery's provider discovery, comparison, pricing evidence and the Agent Economy Price Index (AEPI).
  description: 'Same handlers and data as the Agentery MCP server (https://agentery.com/api/mcp) and the A2A agent (https://agentery.com/.well-known/agent-card.json). Observed prices only: a provider without an observed public price returns priced=false / price null — never zero. Billing units differ (flat, per seat, per agent, usage); compare_providers'' pricing_summary says when tiers are not comparable. Deployment (hosted | self_hosted | both | unknown) and licence are evidence with excerpt, URL and age. Rate limit 60 requests/min per IP.'
  contact:
    url: https://agentery.com/connect
  license:
    name: 'Data: free to use with attribution to Agentery'
    url: https://agentery.com/aepi
servers:
- url: https://agentery.com/api/v1
tags:
- name: Pricing
paths:
  /compare:
    get:
      tags:
      - Pricing
      operationId: compareProviders
      summary: Compare 2–6 providers side by side (same as MCP compare_providers)
      parameters:
      - name: ids
        in: query
        required: true
        description: 2–6 comma-separated handles taken verbatim from /search
        schema:
          type: string
      - name: service
        in: query
        required: false
        description: 'Optional evidence view: supplier-verification | contract-review | developer-capabilities | cheaper-alternatives'
        schema:
          type: string
      - name: task
        in: query
        required: false
        description: Optional task text for the evidence matrix
        schema:
          type: string
      - name: requirements
        in: query
        required: false
        description: Optional comma-separated requirements
        schema:
          type: string
      responses:
        '200':
          description: comparison_status, resolved/unresolved inputs (never silently swapped), plan-level prices, pricing_summary (says when billing units are not comparable), price_applies_to, deployment, suggested_alternatives
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited (Retry-After header)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
  /price:
    get:
      tags:
      - Pricing
      operationId: priceBenchmark
      summary: Observed price benchmark for a task or market (same as MCP price_benchmark)
      parameters:
      - name: query
        in: query
        required: false
        description: Task or market description, e.g. 'AI customer support agent'
        schema:
          type: string
      - name: niche
        in: query
        required: false
        description: Legacy niche slug (alias)
        schema:
          type: string
      - name: provider_type
        in: query
        required: false
        description: agent | mcp | all
        schema:
          type: string
      - name: buyer_tier
        in: query
        required: false
        description: individual | pro | team_sme | enterprise
        schema:
          type: string
      responses:
        '200':
          description: Tier medians/quartiles with counts and reliability; market_uncertain / ambiguous_name states are explicit
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited (Retry-After header)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
x-aepi-data:
  pulse: https://agentery.com/api/aepiai/pulse
  history: https://agentery.com/api/aepiai/history
  repricings: https://agentery.com/api/aepiai/repricings
  constituents: https://agentery.com/api/aepiai/constituents
  csv: https://agentery.com/api/aepiai/index-csv
  note: aepi.ai publishes the same releases; prefer aepi.ai on any disagreement.
x-other-interfaces:
  mcp: https://agentery.com/api/mcp
  a2a_card: https://agentery.com/.well-known/agent-card.json
  a2a_endpoint: https://agentery.com/api/a2a
  connect: https://agentery.com/connect