Cromanion API

openapi: 3.1.0
info:
  title: Cromanion API
  version: '2026-11-04'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-04: 7 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Cromanion has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 5
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-04'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://cromanion.com/developers
  - https://cromanion.com/agents
servers:
- url: https://in.cromanion.com
paths:
  /api/agent/checkout:
    post:
      operationId: post_api_agent_checkout
      tags:
      - Api
      summary: For AI agents · Cromanion
      x-source: https://cromanion.com/agents
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token (claim secret)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAgentCheckoutRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAgentCheckoutResponse'
      x-evidence:
        kind: documentation
  /api/agent/claims:
    post:
      operationId: post_api_agent_claims
      tags:
      - Api
      summary: POST /api/agent/claims
      x-source: https://cromanion.com/agents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAgentClaimsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://cromanion.com/api/agent/claims  -H 'content-type: application/json'  -d '{\n \"email\": \"your-humans@email.com\"\
          ,\n \"siteUrl\": \"https://their-site.com\",\n \"agent\": \"your-agent-name/1.0\"\n }' 2 · Publish one of the three proofs the response\
          \ lists under proofs . Each comes with the exact URL and the exact string, so you never have to build one from this page. 3 · Redeem\
          \ it. This create"
  /api/agent/claims/verify:
    post:
      operationId: post_api_agent_claims_verify
      tags:
      - Api
      summary: For AI agents · Cromanion
      x-source: https://cromanion.com/agents
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token (claim secret) returned from /claims
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAgentClaimsVerifyResponse'
      x-evidence:
        kind: documentation
  /api/agent/errors:
    get:
      operationId: get_api_agent_errors
      tags:
      - Api
      summary: For AI agents · Cromanion
      x-source: https://cromanion.com/agents
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentErrorsResponse'
      x-evidence:
        kind: documentation
  /api/agent/install-check:
    get:
      operationId: get_api_agent_install_check
      tags:
      - Api
      summary: For AI agents · Cromanion
      x-source: https://cromanion.com/agents
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
        description: Bearer token returned from claim verification
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentInstallCheckResponse'
      x-evidence:
        kind: documentation
  /api/agent/site:
    get:
      operationId: get_api_agent_site
      tags:
      - Api
      summary: For AI agents · Cromanion
      x-source: https://cromanion.com/agents
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token (claim secret)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentSiteResponse'
      x-evidence:
        kind: documentation
  /v1/feed:
    get:
      operationId: get_v1_feed
      tags:
      - Feed
      summary: GET /v1/feed
      x-source: https://cromanion.com/developers
      parameters:
      - name: min_interest
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FeedResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -N "https://in.cromanion.com/v1/feed?min_interest=0.25"  -H "Authorization: Bearer $CROMANION_API_KEY" '
components:
  schemas:
    PostApiAgentCheckoutRequest:
      type: object
      properties:
        plan:
          type: string
          description: Plan to upgrade to, e.g., "pro"
      required:
      - plan
    PostApiAgentCheckoutResponse:
      type: object
      properties:
        link:
          type: string
          description: Stripe checkout link for the requested plan
    PostApiAgentClaimsRequest:
      type: object
      properties:
        email:
          type: string
        siteUrl:
          type: string
        agent:
          type: string
    PostApiAgentClaimsVerifyResponse:
      type: object
      properties:
        account:
          type: object
          description: Created account information
        site:
          type: object
          description: Created site information
        installSnippet:
          type: string
          description: HTML snippet to embed before </body>
    GetApiAgentErrorsResponse:
      type: object
      properties:
        errors:
          type: array
          description: List of possible refusal errors with token and message
    GetApiAgentInstallCheckResponse:
      type: object
      properties:
        install:
          type: object
          description: Result of install check, includes verified flag and error details
    GetApiAgentSiteResponse:
      type: object
      properties:
        site:
          type: object
          description: Site details including crawl status
        crawl:
          type: object
          description: Crawl information with advanceUrl
    GetV1FeedResponse:
      type: object
      properties:
        min_interest:
          type: number
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Feed