MarketPilot Public API

The Public API from MarketPilot — 10 operation(s) for public.

GitHub OpenAPI

Operations 10

GET /v1/public/press-media (인증 불필요) 뉴스기사 발행 — 보도 종류·등급·1건 단가·언론사 급(A~D급)별 곳 수. #
GET /v1/public/ai-catalog (인증 불필요) 서비스·상품 전체 카탈로그 — 추천용 공개 데이터 #
POST /v1/public/ai-checkout (인증 불필요) 카드 결제 링크 만들기 — 상품 id·수량만 보내면 금액은 서버가 계산. #
GET /v1/public/ai-checkout/{checkoutToken} (인증 불필요) 결제 링크 상태 — 결제 대기·완료·만료와 결제 후 만들어진 주문의 진행 상황 #
POST /v1/public/ai-signup/send-code (인증 불필요) 가입용 휴대폰 인증번호 발송 — 계정이 없는 사용자의 1단계 #
POST /v1/public/ai-signup (인증 불필요) 인증번호 확인 + 계정 생성 + API 키 발급 — 가입 2단계 #
POST /v1/public/ai-inquiry (인증 불필요) 상담·견적 문의 접수 — 주문할 수 없거나 사람과 이야기해야 할 때 #
GET /v1/public/ai-forms (인증 불필요) 사이트의 모든 공개 문의 폼 명세 — 어디에 무엇을 보낼지 목록 #
POST /v1/public/support-profile (인증 불필요) 가입 전 사업 프로필 드래프트 등록 — draftToken + 추천 미리보기. 가입/로그인 후 토큰으로 계정에 연결 #
GET /v1/public/support-profile/matches (인증 불필요) 드래프트 추천 미리보기 재조회 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/marketpilot-it:marketpilot-it-public-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

marketpilot-it-public-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: 마켓파일럿 AI 주문 Public API
  version: 1.0.0
  description: '마케팅 상품 조회·견적·주문·주문내역·포인트 충전 API. 주문은 견적(quote) → 확정(confirm) 2단계이며, 확정 전 사용자 승인이 필요해요. 자세한 가이드: https://api.marketpilot.it/v1/ai/docs'
servers:
- url: https://api.marketpilot.it/v1/ai
security:
- bearerAuth: []
tags:
- name: Public
paths:
  /v1/public/press-media:
    get:
      operationId: getPublicPressMedia
      summary: (인증 불필요) 뉴스기사 발행 — 보도 종류·등급·1건 단가·언론사 급(A~D급)별 곳 수.
      servers:
      - url: https://api.marketpilot.it
      security: []
      responses:
        '200':
          description: namesHidden:true · pressTypes[].tiers[].gradeCounts · mediaCount · unitPrice · autoAssign · guideRule · howToOrder (tiers[].media 는 빈 배열)
      tags:
      - Public
  /v1/public/ai-catalog:
    get:
      operationId: getPublicCatalog
      summary: (인증 불필요) 서비스·상품 전체 카탈로그 — 추천용 공개 데이터
      servers:
      - url: https://api.marketpilot.it
      security: []
      responses:
        '200':
          description: brand·integration·services(AI 매칭 메타 포함)·products(기본 단가)
      tags:
      - Public
  /v1/public/ai-checkout:
    post:
      operationId: createCheckout
      summary: (인증 불필요) 카드 결제 링크 만들기 — 상품 id·수량만 보내면 금액은 서버가 계산.
      servers:
      - url: https://api.marketpilot.it
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - items
              - customerName
              properties:
                items:
                  type: array
                  minItems: 1
                  maxItems: 10
                  items:
                    type: object
                    required:
                    - productId
                    - quantity
                    properties:
                      productId:
                        type: integer
                        description: 카탈로그의 productId
                      quantity:
                        type: integer
                        minimum: 1
                        description: 상품의 최소·최대·배수 제약을 지켜야 해요
                customerName:
                  type: string
                  description: 받는 분 이름 또는 상호 — 사용자에게 직접 물어본 값
                customerPhone:
                  type: string
                  description: 휴대폰 번호 (선택, 권장)
                customerEmail:
                  type: string
                companyName:
                  type: string
                note:
                  type: string
                  description: 요청 메모 (매장 주소·원하는 시작일 등)
                agentName:
                  type: string
                  description: 이 요청을 넣는 AI 이름
      responses:
        '201':
          description: checkoutUrl · checkoutToken · totalAmount · expiresAt · items[] · nextStep
        '400':
          description: 주문할 수 없는 상품·수량 제약 위반·금액 범위(1,000원~2,000,000원) 밖
        '429':
          description: 발행 상한 초과
      tags:
      - Public
  /v1/public/ai-checkout/{checkoutToken}:
    get:
      operationId: getCheckoutStatus
      summary: (인증 불필요) 결제 링크 상태 — 결제 대기·완료·만료와 결제 후 만들어진 주문의 진행 상황
      servers:
      - url: https://api.marketpilot.it
      security: []
      parameters:
      - name: checkoutToken
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: status · paid · orders[](statusLabel·inputRequired) · setupUrl · nextStep
        '404':
          description: 없는 토큰
      tags:
      - Public
  /v1/public/ai-signup/send-code:
    post:
      operationId: sendSignupCode
      summary: (인증 불필요) 가입용 휴대폰 인증번호 발송 — 계정이 없는 사용자의 1단계
      servers:
      - url: https://api.marketpilot.it
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - phone
              properties:
                phone:
                  type: string
                  description: 010으로 시작하는 휴대폰 번호
      responses:
        '200':
          description: 발송 완료 — 사용자에게 문자로 받은 번호를 물어보세요 (3분 유효)
        '400':
          description: 유효하지 않은 번호이거나 이미 가입된 번호
      tags:
      - Public
  /v1/public/ai-signup:
    post:
      operationId: signUp
      summary: (인증 불필요) 인증번호 확인 + 계정 생성 + API 키 발급 — 가입 2단계
      servers:
      - url: https://api.marketpilot.it
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - phone
              - code
              - loginId
              - password
              - name
              - agreedToTerms
              - agreedToPrivacy
              properties:
                phone:
                  type: string
                code:
                  type: string
                  description: 문자로 받은 인증번호
                loginId:
                  type: string
                  minLength: 4
                  description: 영문·숫자 4자 이상
                password:
                  type: string
                  minLength: 8
                name:
                  type: string
                  maxLength: 15
                email:
                  type: string
                companyName:
                  type: string
                agreedToTerms:
                  type: boolean
                  description: 반드시 사용자에게 직접 확인받고 넣을 것 — AI가 임의로 true 금지
                agreedToPrivacy:
                  type: boolean
                  description: 반드시 사용자에게 직접 확인받고 넣을 것
                agreedToMarketing:
                  type: boolean
                issueApiKey:
                  type: boolean
                  default: true
                  description: false면 키를 발급하지 않음
                agentName:
                  type: string
      responses:
        '200':
          description: userId·loginId·apiKey(mk_) 반환. apiKey는 자격증명이니 안전하게 전달할 것
        '400':
          description: 인증번호 불일치·만료, 약관 미동의, 중복 아이디/번호
      tags:
      - Public
  /v1/public/ai-inquiry:
    post:
      operationId: submitInquiry
      summary: (인증 불필요) 상담·견적 문의 접수 — 주문할 수 없거나 사람과 이야기해야 할 때
      servers:
      - url: https://api.marketpilot.it
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - message
              - contactName
              - contactEmail
              properties:
                message:
                  type: string
                  minLength: 10
                  description: 업종·목표·상황을 정리해 10자 이상
                contactName:
                  type: string
                  description: 사용자에게 직접 확인 — 지어내지 말 것
                contactEmail:
                  type: string
                  description: 사용자에게 직접 확인 — 지어내지 말 것
                inquiryType:
                  type: string
                  enum:
                  - consultation
                  - quote
                  - service
                  - partnership
                  - support
                  - other
                contactPhone:
                  type: string
                companyName:
                  type: string
                businessType:
                  type: string
                budget:
                  type: string
                interestedServices:
                  type: array
                  items:
                    type: string
                agentName:
                  type: string
      responses:
        '200':
          description: 접수 완료 — reference(MP-AI-n) 반환, 영업일 1일 내 이메일 회신
      tags:
      - Public
  /v1/public/ai-forms:
    get:
      operationId: listPublicForms
      summary: (인증 불필요) 사이트의 모든 공개 문의 폼 명세 — 어디에 무엇을 보낼지 목록
      servers:
      - url: https://api.marketpilot.it
      security: []
      responses:
        '200':
          description: 폼별 엔드포인트·필수 필드·용도 (.md 버전도 제공)
      tags:
      - Public
  /v1/public/support-profile:
    post:
      operationId: createSupportProfileDraft
      summary: (인증 불필요) 가입 전 사업 프로필 드래프트 등록 — draftToken + 추천 미리보기. 가입/로그인 후 토큰으로 계정에 연결
      servers:
      - url: https://api.marketpilot.it
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - industries
              - region
              properties:
                industries:
                  type: array
                  items:
                    type: string
                  description: 업종 (복수) — /support/profile 과 동일 라벨
                region:
                  type: string
                  description: 시·도
                bizName:
                  type: string
                startupStage:
                  type: string
                  enum:
                  - PROSPECTIVE
                  - EARLY
                  - GROWTH
                  - ESTABLISHED
                founderAgeGroup:
                  type: string
                  enum:
                  - YOUTH
                  - MIDDLE
                founderGender:
                  type: string
                  enum:
                  - MALE
                  - FEMALE
                bizType:
                  type: string
                  enum:
                  - INDIVIDUAL
                  - CORPORATION
                  - PRELIMINARY
                isTechBased:
                  type: boolean
                openDate:
                  type: string
                regionDetail:
                  type: string
                employeeCount:
                  type: integer
                interestTags:
                  type: array
                  items:
                    type: string
                businessDescription:
                  type: string
                  maxLength: 500
                  description: 무엇을 누구에게 파는지 한두 줄
                bizRegistrationNo:
                  type: string
                  description: 사업자등록번호
                bizItems:
                  type: array
                  items:
                    type: object
                    properties:
                      category:
                        type: string
                      item:
                        type: string
                      code:
                        type: string
                    required:
                    - item
                  description: 사업자등록증 업태·종목 (나라장터 투찰가능업종 판정용)
                agentName:
                  type: string
                  description: 등록하는 AI 이름
      responses:
        '201':
          description: draftToken(spd_…)·preview(top 8)·claimUrl — 토큰은 연결 열쇠이니 사용자에게 보관 안내. profile.completeness.missing 질문을 이어서 물어 값을 합친 뒤 다시 등록하면 새 draftToken 이 나와요
      tags:
      - Public
  /v1/public/support-profile/matches:
    get:
      operationId: previewSupportProfileDraft
      summary: (인증 불필요) 드래프트 추천 미리보기 재조회
      servers:
      - url: https://api.marketpilot.it
      security: []
      parameters:
      - name: token
        in: query
        required: true
        schema:
          type: string
          description: draftToken (spd_…)
      - name: limit
        in: query
        schema:
          type: integer
          default: 8
          maximum: 20
      responses:
        '200':
          description: profile·top·total·claimed·claimUrl
      tags:
      - Public
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: www.marketpilot.it/developer/api-keys 에서 발급한 mk_ 키