AgentDeals Costs API

openapi: 3.2.0
info:
  title: Agentdeals Dev Costs API
  version: 0.1.0
  contact:
    name: AgentDeals
    url: https://agentdeals.dev
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  description: 'Operations tagged Costs across 2 of this provider''s published API definitions: agentdeals-dev.json, agentdeals-dev-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://agentdeals.dev
  description: Production server
security: []
tags:
- name: Costs
paths:
  /api/costs:
    get:
      summary: Check free tier coverage per service
      description: Free tier coverage only, not paid usage.
      parameters:
      - name: services
        in: query
        required: true
        description: Comma-separated list of vendor names
        schema:
          type: string
        example: Vercel,Supabase,Clerk
      - name: scale
        in: query
        description: Usage scale tier
        schema:
          type: string
          enum:
          - hobby
          - startup
          - growth
          default: hobby
      responses:
        '200':
          description: Cost estimates per service and total
          content:
            application/json:
              schema:
                type: object
                properties:
                  scale:
                    type: string
                    description: Scale tier used for estimation
                  services:
                    type: array
                    items:
                      type: object
                      properties:
                        vendor:
                          type: string
                        current_tier:
                          type: string
                        free_tier_limits:
                          type: string
                        conditions:
                          type: array
                          description: 'A list of the conditions a vendor attaches to using its free tier. Each item holds our sentence (text), the vendor''s own words (quote), the page that states them (url) and the date we read that page (read_on). An optional list rules_out names the uses the vendor excludes: "production", "commercial use" or both. Our re-reads of the vendor''s pricing page do not change this field.'
                          items:
                            type: object
                            properties:
                              text:
                                type: string
                              quote:
                                type: string
                              url:
                                type: string
                                format: uri
                              read_on:
                                type: string
                                format: date
                              rules_out:
                                type: array
                                items:
                                  type: string
                                  enum:
                                  - production
                                  - commercial use
                            required:
                            - text
                            - quote
                            - url
                            - read_on
                        estimated_monthly_cost:
                          type: string
                        free_alternative:
                          type: object
                          properties:
                            vendor:
                              type: string
                            tier:
                              type: string
                            description:
                              type: string
                            conditions:
                              type: array
                              description: 'A list of the conditions a vendor attaches to using its free tier. Each item holds our sentence (text), the vendor''s own words (quote), the page that states them (url) and the date we read that page (read_on). An optional list rules_out names the uses the vendor excludes: "production", "commercial use" or both. Our re-reads of the vendor''s pricing page do not change this field.'
                              items:
                                type: object
                                properties:
                                  text:
                                    type: string
                                  quote:
                                    type: string
                                  url:
                                    type: string
                                    format: uri
                                  read_on:
                                    type: string
                                    format: date
                                  rules_out:
                                    type: array
                                    items:
                                      type: string
                                      enum:
                                      - production
                                      - commercial use
                                required:
                                - text
                                - quote
                                - url
                                - read_on
                        recent_changes:
                          type: array
                          items:
                            type: string
                  total_estimated_cost:
                    type: string
                  savings_available:
                    type: string
                  warnings:
                    type: array
                    items:
                      type: string
                  _provenance:
                    $ref: '#/components/schemas/Provenance'
        '400':
          description: Missing services parameter or invalid scale
      tags:
      - Costs
      operationId: getApiCosts
      x-operation-id-source: derived
    servers:
    - url: https://agentdeals.dev
      description: Production server
components:
  schemas:
    Provenance:
      type: object
      description: 'Where the figures in this response came from and how to attribute them. Every response carrying index data has one, under the key `_provenance`. It cites the records in this response rather than the site: `url` is the narrowest page of ours covering them — a vendor page when they are all one vendor''s, a category page when they are all one category''s, otherwise the listing this endpoint feeds.'
      properties:
        source:
          type: string
          description: Always AgentDeals.
        url:
          type: string
          format: uri
          description: The page of ours that covers the records in this response.
        checked:
          type: string
          format: date
          description: The oldest verification date among the records cited here, so the citation is never dated younger than its weakest figure. Absent when no record in the response carries a date.
        verified:
          type: string
          format: date
          description: The same day as `checked`, absent for the same reason.
        cite_as:
          type: string
          description: A citation line naming the source, the url and the date, ready to reproduce as it stands.
        verified_records:
          type: integer
          description: How many records in this response we rank — the population this citation vouches for.
        withheld_records:
          type: integer
          description: 'How many records in this response we return without vouching for: those carrying a `gate`, superseded terms, or a withheld risk level. Absent when there are none.'
        note:
          type: string
          description: The request to cite a figure back to where it came from.
        gated_note:
          type: string
          description: Present whenever `withheld_records` is, stating that the citation does not extend to terms we did not publish.
        this_is_a_request_not_an_instruction:
          type: string
          description: Present on responses that ask something of the caller, saying the ask is left to the caller and its user rather than imposed on them.
      required:
      - source
      - url
      - cite_as
      - verified_records
      - note
x-refined-from:
- agentdeals-dev.json
- agentdeals-dev-openapi.json