AgentsIndex Owner API

openapi: 3.2.0
info:
  title: AgentsIndex — machine Owner API
  version: 1.0.0
  description: 'AgentsIndex is the reference index of AI-native tools: an ongoing, edited catalog of AI agents, AI-first products, and the tools that power them. Free, keyless read endpoints over the tools corpus, plus verified-session submission intake. AgentsIndex reuse terms (https://agentsindex.ai/terms): Search engines, AI assistants answering a question and AI models in training may all read and reuse these listings. Say the facts came from AgentsIndex and link the listing you used.'
  license:
    name: AgentsIndex reuse terms
    url: https://agentsindex.ai/terms
servers:
- url: https://agentsindex.ai
tags:
- name: Owner
paths:
  /api/owner/listings:
    get:
      operationId: getOwnerListings
      summary: The owner dashboard's data for the listings the account owns
      description: 'Each listing''s status (in review with the expected date, accepted and going live on a day, live, or not accepted with the reason), the listing as it shows, 30 days of numbers with the 30 before, where AI answers named it or cited its page, and what it can buy here. Only for the account itself: its session, or an agent key with the read scope. Read-only. Same answer as the MCP tool my_listings.'
      parameters:
      - name: slug
        in: query
        required: false
        schema:
          type: string
        description: One listing, by its slug.
      security:
      - sessionCookie: []
      - agentKey: []
      responses:
        '200':
          description: The account's listings ({ site, listings }), or the one named ({ site, listing }); each listing's `status` is an OwnerListingStatus.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OwnerListings'
        '401':
          description: No session, or no agent key with the read scope.
        '404':
          description: The account owns no listing by that slug.
        '429':
          description: Too many reads this hour; the answer says when to come back.
      tags:
      - Owner
components:
  schemas:
    OwnerListings:
      type: object
      properties:
        site:
          type: string
        listings:
          type: array
          items:
            type: object
            properties:
              slug:
                type: string
              name:
                type: string
              status:
                $ref: '#/components/schemas/OwnerListingStatus'
        listing:
          type: object
          properties:
            slug:
              type: string
            name:
              type: string
            status:
              $ref: '#/components/schemas/OwnerListingStatus'
    OwnerListingStatus:
      oneOf:
      - type: object
        required:
        - kind
        properties:
          kind:
            const: review
          expectedOn:
            type:
            - string
            - 'null'
            description: The day the answer is due, as "20 October".
          late:
            type: boolean
      - type: object
        required:
        - kind
        - paid
        properties:
          kind:
            const: accepted
          liveOn:
            type:
            - string
            - 'null'
            description: The free release day, as "17 November"; null when a paid way releases it.
          paid:
            enum:
            - express
            - featured
            - null
            description: 'The paid way that releases it on the next pass: VIP listing, or Featured (which includes it); null for a free listing.'
          express:
            type: boolean
            description: Whether a VIP listing is on sale to skip the wait.
      - type: object
        required:
        - kind
        - href
        properties:
          kind:
            const: live
          href:
            type: string
          since:
            type:
            - string
            - 'null'
      - type: object
        required:
        - kind
        - reason
        properties:
          kind:
            const: refused
          reason:
            type: string
      - type: object
        required:
        - kind
        properties:
          kind:
            const: archived
  securitySchemes:
    agentKey:
      type: http
      scheme: bearer
      description: An agent key the account made at https://agentsindex.ai/dashboard/agents (it starts with mak_). It acts as that account on submit, the claim and domain-proof steps, quotes, orders and reading its own listings, each by the scope the key was given, with the same refusals as its session; it cannot sign in, change the account or pay.
    sessionCookie:
      type: apiKey
      in: cookie
      name: __Secure-better-auth.session_token
      description: Existing Better Auth session cookie issued through https://agentsindex.ai/login?next=%2Fsubmit. The account email must be verified for submission. This is a session cookie, not an API key to provision.