Getting Started

Markidy API

Build integrations, automate workflows, and connect apps or AI tools to Markidy — The Open Matching Network.

Base URL

https://api.markidy.com/v1

All API requests must use HTTPS. HTTP requests will be redirected.

Quick Start

Get started by making your first API call. You'll need an API key from your Dashboard.

1. Get your API key

Navigate to Dashboard → API Keys and create a new key.

2. Make your first request

cURL

curl https://api.markidy.com/v1/listings/search?category=jobs \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Response

Response

{
  "listings": [
    {
      "id": "clx...",
      "title": "Hiring Backend Engineer for Seoul Team",
      "description": "Looking for an experienced backend engineer to join our product team.",
      "categoryKey": "jobs",
      "categoryName": "Jobs",
      "roleKey": "employer",
      "roleName": "Employer",
      "verifiedLevel": 1,
      "country": "kr",
      "displayName": "John",
      "createdAt": "2026-03-15T10:00:00Z"
    }
  ],
  "total": 45,
  "page": 1,
  "pageSize": 16
}

What can you build?

REST API

Integrate with Markidy programmatically — search, match, and manage listings.

MCP Server

Connect AI assistants like Claude and Cursor directly to Markidy.

CLI Tool

Search, filter, and interact with Markidy from your terminal.

Webhooks

Receive real-time notifications for match requests and automate your pipeline.

Next Authentication →