GrowVib Catalog API

openapi: 3.2.0
info:
  contact:
    email: support@growvib.com
    name: GrowVib
    url: https://growvib.com/contact
  description: 'This document covers the anonymous catalog reads of the GrowVib API. AI agents acting for a GrowVib user connect through the MCP server instead (OAuth 2.1 with PKCE, see the server card and auth.md linked below). Prices returned by every endpoint are the live list prices every buyer sees.


    Errors share one JSON shape: `{"error": "", "code": , "details"?: "", "reason"?: ""}`. Branch on `code` and `reason`, never on the message text.'
  summary: Browse the GrowVib social growth catalog for Telegram, Instagram, TikTok, YouTube and more.
  termsOfService: https://growvib.com/terms
  title: GrowVib Catalog API
  version: 1.0.0
  x-service-info:
    agent_docs: https://growvib.com/auth.md
    categories:
    - social-media-growth
    - marketing
    llms_txt: https://growvib.com/llms.txt
    mcp_server_card: https://api.growvib.com/.well-known/mcp/server-card.json
    x402:
      asset: USDC
      discovery: bazaar
      docs: https://growvib.com/x402
      endpoint: https://api.growvib.com/v1/agent/orders
      network: eip155:8453
      networks:
      - eip155:8453
      - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
      order_status:
        auth: Bearer <agent_token>
        endpoint: https://api.growvib.com/v1/agent/orders/{order_id}
        method: GET
      protocol: x402
      version: 2
servers:
- url: https://api.growvib.com
tags:
- description: Anonymous catalog reads. No credentials, per-IP rate limited.
  name: Catalog
paths:
  /v1/services:
    get:
      description: The public catalog, paginated. Each service carries its plan options with live per-1000 prices and quantity bounds.
      operationId: listCatalogServices
      parameters:
      - description: Filter by platform key.
        in: query
        name: platform_key
        schema:
          examples:
          - telegram
          - instagram
          - tiktok
          - youtube
          type: string
      - description: Filter by the metric the service grows.
        in: query
        name: metric
        schema:
          examples:
          - members
          - followers
          - views
          - likes
          type: string
      - description: Keyword search over names and descriptions.
        in: query
        name: search
        schema:
          type: string
      - description: Language for names and descriptions.
        in: query
        name: locale
        schema:
          default: en
          type: string
      - in: query
        name: quality_tier
        schema:
          type: string
      - in: query
        name: speed_tier
        schema:
          type: string
      - description: Minimum price per 1000, USD.
        in: query
        name: min_price
        schema:
          type: number
      - description: Maximum price per 1000, USD.
        in: query
        name: max_price
        schema:
          type: number
      - in: query
        name: page
        schema:
          default: 1
          minimum: 1
          type: integer
      - in: query
        name: page_size
        schema:
          default: 10
          maximum: 100
          minimum: 1
          type: integer
      - in: query
        name: sort_by
        schema:
          type: string
      - in: query
        name: sort_order
        schema:
          enum:
          - asc
          - desc
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/Service'
                    type: array
                  page:
                    type: integer
                  page_size:
                    type: integer
                  total:
                    type: integer
                required:
                - data
                - page
                - page_size
                - total
                type: object
          description: A page of services.
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
      summary: List sellable services
      tags:
      - Catalog
  /v1/services/{id}:
    get:
      operationId: getCatalogService
      parameters:
      - in: path
        name: id
        required: true
        schema:
          format: uuid
          type: string
      - in: query
        name: locale
        schema:
          default: en
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceDetail'
          description: The service.
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
      summary: Get one service with its plan options
      tags:
      - Catalog
components:
  responses:
    NotFound:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Not found, or not this account's.
    RateLimited:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Rate limit reached; `Retry-After` says when to retry.
  schemas:
    ServiceDetail:
      allOf:
      - $ref: '#/components/schemas/Service'
      - properties:
          instructions:
            type: string
        type: object
    Service:
      additionalProperties: true
      properties:
        id:
          format: uuid
          type: string
        long_description:
          type: string
        metric:
          type: string
        name:
          type: string
        options:
          items:
            $ref: '#/components/schemas/ServiceOption'
          type: array
        platform_key:
          type: string
        quality_tier:
          type: string
        service_category_key:
          type: string
        service_category_name:
          type: string
        short_description:
          type: string
        slug:
          type: string
        speed_label:
          type: string
        speed_tier:
          type: string
        start_label:
          type: string
        starting_price_usd:
          description: Cheapest option price per 1000 units, USD.
          type: number
        tags:
          items:
            type: string
          type: array
      type: object
    ServiceOption:
      additionalProperties: true
      description: 'One plan of a service: a quality or speed variant with its own price and quantity bounds.'
      properties:
        cancelable:
          type:
          - boolean
          - 'null'
        display_label:
          type: string
        id:
          format: uuid
          type: string
        instructions:
          type: string
        max_quantity:
          type:
          - number
          - 'null'
        min_quantity:
          type:
          - number
          - 'null'
        option_group:
          type: string
        price_usd:
          description: Price per 1000 units, USD.
          type: number
        slug:
          type: string
        status:
          type: string
      type: object
    Error:
      properties:
        code:
          description: The HTTP status.
          type: integer
        details:
          type: string
        error:
          type: string
        reason:
          description: A stable machine-readable reason, for example `insufficient_balance`.
          type: string
      required:
      - error
      - code
      type: object
externalDocs:
  description: Agent access and authentication guide
  url: https://growvib.com/auth.md