Getting Started

Markidy API

Build integrations, automate workflows, and connect AI agents to Markidy — The Intent 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": "AI Agent Developer with 5 Years of Python Experience",
      "description": "Specializing in chatbots, RAG pipelines, and workflow automation.",
      "categoryKey": "ai-agent",
      "categoryName": "AI Agent",
      "roleKey": "developer",
      "roleName": "AI Developer",
      "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 →