AI Directories

आधिकारिक

एआई डायरेक्ट्रीज़ कैटलॉग खोजें, लिस्टिंग देखें, और सबमिशन डायरेक्ट्रीज़ ब्राउज़ करें

AI Directories MCP के साथ आप क्या कर सकते हैं?

  • AI टूल खोजें — कीवर्ड, श्रेणी, टैग या मूल्य निर्धारण द्वारा AI टूल खोजने के लिए search_tools का उपयोग करके पूछें।
  • टूल विवरण प्राप्त करें — स्लग द्वारा किसी भी टूल की पूरी सार्वजनिक सूची get_tool के माध्यम से मांगें, जिसमें स्क्रीनशॉट और FAQ शामिल हों।
  • शीर्ष टूल ब्राउज़ करें — ओपन्स के आधार पर सबसे लोकप्रिय AI टूल पूछें, वैकल्पिक रूप से श्रेणी द्वारा फ़िल्टर किया हुआ, get_top_tools के साथ।
  • श्रेणियाँ और टैग एक्सप्लोर करें — सहायक को list_categories या list_tags का उपयोग करके सभी AI टूल श्रेणियों या टैग को गिनती के साथ सूचीबद्ध करने दें।
  • सबमिशन निर्देशिकाएँ खोजें — सबमिशन लक्ष्यों की पहचान करने के लिए search_directories के साथ नाम, लागत या श्रेणी द्वारा निर्देशिकाएँ खोजें।
  • निर्देशिका प्रोफ़ाइल प्राप्त करें — get_directory के माध्यम से किसी निर्देशिका की पूरी प्रोफ़ाइल प्राप्त करें, जिसमें डोमेन रेटिंग और बैज आवश्यकताएँ शामिल हों।

दस्तावेज़

Developers

Claude में खोलें

API और MCP

आधिकारिक AI Directories कैटलॉग — curl या किसी एजेंट से AI टूल्स और सबमिशन डायरेक्ट्री खोजें। मुफ्त, प्रलेखित, और स्क्रैपिंग से बेहतर।

RESTGET · Bearer aid_

www.aidirectori.es/api/v1

MCPStreamable HTTP

api/mcp

OpenAPImachine spec

openapi.json

AI Directories कैटलॉग खोजें, किसी लिस्टिंग को देखें, और सबमिशन डायरेक्ट्री ब्राउज़ करें — किसी एजेंट या curl से। REST और MCP एक ही बैकएंड साझा करते हैं। तृतीय-पक्ष स्क्रैपर्स हमारे सार्वजनिक पृष्ठों को लपेटते हैं और डंप के लिए शुल्क लेते हैं। यह आधिकारिक स्रोत है।

उदाहरण — GET /tools/transclipper

curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
  -H "Authorization: Bearer aid_your_api_key"
{
  "success": true,
  "data": {
    "id": "69b81f3e40816562014e004a",
    "slug": "transclipper",
    "name": "TransClipper",
    "url": "https://www.aidirectori.es/ai-tools/transclipper",
    "website": "https://transclipper.ai",
    "tagline": "Steal the Blueprint Behind Any Viral Video",
    "description": "TransClipper is a powerful AI-driven tool designed for efficient content clipping and transcription.",
    "category": { "slug": "video", "name": "Video" },
    "tags": [
      { "slug": "ai", "name": "AI" },
      { "slug": "content-creation", "name": "Content Creation" }
    ],
    "pricing": "FREE",
    "rating": 4,
    "opens": 4030,
    "featured": true,
    "icon": "https://cdn.aidirectori.es/icons/1784893027853-vpj1hwsqkq.png"
  }
}

आप क्या कर सकते हैं

  • कीवर्ड, श्रेणी, टैग, या मूल्य निर्धारण द्वारा AI टूल्स खोजें
  • स्लग द्वारा एक टूल प्राप्त करें (पूर्ण सार्वजनिक लिस्टिंग)
  • श्रेणियाँ और टैग सूचीबद्ध करें
  • सबमिशन डायरेक्ट्री खोजें (DR, लागत, बैज)
  • अपनी aid_ कुंजी के साथ एक डायरेक्ट्री प्रोफ़ाइल प्राप्त करें

आप क्या नहीं कर सकते

  • संस्थापक ईमेल या निजी एनालिटिक्स पढ़ें
  • HTML साइट स्क्रैप करें या क्रॉलर का रूप धारण करें
  • कैटलॉग को प्रतिस्पर्धी डायरेक्ट्री के रूप में पुनः प्रकाशित करें
  • जारी की गई कुंजी के बिना पार्टनर राइट APIs को कॉल करें

यह क्यों मौजूद है

लोग aidirectori.es को स्क्रैप कर रहे थे और निर्यात बेच रहे थे। आधिकारिक API उत्पादों, शोध, और एजेंटों के लिए मुफ्त है — एट्रिब्यूशन, दर सीमाएँ, और लाइसेंस के साथ: आप पूर्ण कैटलॉग को प्रतिस्पर्धी डायरेक्ट्री या भुगतान किए गए स्क्रैप के रूप में पुनः प्रकाशित नहीं कर सकते।

किसी एजेंट में डालें

Cursor: .cursor/mcp.json या ~/.cursor/mcp.json। Authorization: के बाद कोई स्थान नहीं — mcp-remote व्हाइटस्पेस पर विभाजित होता है। MCP इंस्टॉल करें देखें।

{
  "mcpServers": {
    "aidirectories": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.aidirectori.es/api/mcp",
        "--header", "Authorization:Bearer aid_your_real_key"
      ]
    }
  }
}

मशीन-पठनीय भी

आरंभ करें / त्वरित आरंभ

त्वरित आरंभ

एक aid_ कुंजी बनाएँ, फिर टूल्स खोजें, एक लिस्टिंग प्राप्त करें, और डायरेक्ट्री खोजें।

डेवलपर डैशबोर्ड पर एक कुंजी बनाएँ, फिर इन्हें कॉपी करें।

1. AI टूल्स खोजें

curl -s "https://www.aidirectori.es/api/v1/tools?q=image&limit=5" \
  -H "Authorization: Bearer aid_your_api_key"

2. एक लिस्टिंग प्राप्त करें

curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
  -H "Authorization: Bearer aid_your_api_key"

3. डायरेक्ट्री खोजें

curl -s "https://www.aidirectori.es/api/v1/directories?q=ai&limit=5" \
  -H "Authorization: Bearer aid_your_api_key"

MCP पर समान संचालन: समान Bearer टोकन के साथ सर्वर जोड़ें, फिर search_tools, get_tool, और search_directories कॉल करें। MCP इंस्टॉल देखें।

आरंभ करें / प्रमाणीकरण

प्रमाणीकरण

API कुंजी के माध्यम से Bearer टोकन। अपने डेवलपर डैशबोर्ड से कुंजियाँ बनाएँ। मानक 10/मिनट, प्रीमियम 60/मिनट।

प्रमाणीकरण

API कुंजी के माध्यम से Bearer टोकन। अपने डेवलपर डैशबोर्ड से कुंजियाँ बनाएँ।

दर सीमाएँ

मानक कुंजियों को 10 अनुरोध प्रति मिनट मिलते हैं। प्रीमियम कुंजियों को 60 मिलते हैं। अपने डेवलपर डैशबोर्ड से अपग्रेड करें। दर-सीमा हेडर हर प्रतिक्रिया पर होते हैं।

आधार URL

https://www.aidirectori.es/api/v1

  1. 1 अपनी API कुंजी प्राप्त करें

    डेवलपर डैशबोर्ड पर जाएँ और एक API कुंजी बनाएँ। कुंजियाँ aid_ से शुरू होती हैं। इसे सुरक्षित रूप से संग्रहीत करें — आप पूर्ण कुंजी फिर से नहीं देख पाएँगे। स्वीकार्य उपयोग आवश्यक है कुंजी बनाने के लिए API स्वीकार्य उपयोग नीति से सहमति आवश्यक है। व्यवसायों की नकल करना, AI Directories का पुनर्निर्माण करना, थोक पुनर्प्रकाशन, अनधिकृत सार्वजनिक SEO पृष्ठ, दुरुपयोगी लक्ष्यीकरण, क्रेडेंशियल साझा करना, और पहुँच-नियंत्रण से बचना निषिद्ध है और स्थायी प्लेटफ़ॉर्म प्रतिबंध का परिणाम हो सकता है।
  2. 2 अपना पहला अनुरोध करें

    अपनी कुंजी को Authorization हेडर में Bearer टोकन के रूप में पास करें। X-API-Key भी स्वीकार किया जाता है, हर एंडपॉइंट पर। दोनों विनिमेय हैं — एक कुंजी जो प्राप्त कर सकती है वह कुंजी पर निर्भर करती है, न कि उस हेडर पर जिसमें वह आती है। एक डैशबोर्ड aid_ कुंजी को X-API-Key के रूप में भेजे जाने पर पार्टनर एंडपॉइंट पर 403 मिलता है; यदि आप 403 देख रहे हैं, तो आपको एक अलग कुंजी चाहिए, अलग हेडर नहीं।
    curl -s "https://www.aidirectori.es/api/v1/tools?q=ai&limit=5" \
      -H "Authorization: Bearer aid_your_api_key"
    
  3. 3 प्रतिक्रिया पार्स करें

    सफल पठन { success: true, data } लौटाता है। सूची एंडपॉइंट में pagination भी शामिल है — इसके फ़ील्ड और सीमा-क्लैम्पिंग नियम पढ़ने योग्य हैं इससे पहले कि आप पेजिंग लूप लिखें। X-RateLimit-Remaining देखें।
    {
      "success": true,
      "data": [
        {
          "slug": "transclipper",
          "name": "TransClipper",
          "website": "https://transclipper.ai"
        }
      ]
    }
    

पार्टनर कुंजियाँ

डायरेक्ट्री पार्टनर जो सबमिशन सेवा के लिए हमें टूल्स भेजते हैं, वे POST /submit-ai-tool, स्थिति, वेबहुक, और समर्थन के लिए जारी की गई कुंजी का उपयोग करते हैं। वे कुंजियाँ कैटलॉग पठन पर भी काम करती हैं। कोई डायरेक्ट्री है? देखें।

MCP / इंस्टॉल

MCP इंस्टॉल करें

होस्टेड Streamable HTTP MCP — REST के समान Bearer कुंजी भेजें।

सर्वर Streamable HTTP पर Model Context Protocol बोलता है। यह होस्टेड है। हर टूल REST API के समान फ़ंक्शन लपेटता है। अपने डेवलपर डैशबोर्ड से Authorization: Bearer aid_… भेजें।

https://www.aidirectori.es/api/mcp

Claude Code

claude mcp add --transport http aidirectories https://www.aidirectori.es/api/mcp \
  --header "Authorization: Bearer aid_your_api_key"

Cursor / Claude Desktop

प्रोजेक्ट स्कोप: .cursor/mcp.json। वैश्विक: ~/.cursor/mcp.json। Claude Desktop: claude_desktop_config.json (केवल stdio — यही ब्लॉक)।

{
  "mcpServers": {
    "aidirectories": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.aidirectori.es/api/mcp",
        "--header", "Authorization:Bearer aid_your_real_key"
      ]
    }
  }
}

Authorization: के बाद कोई स्थान नहीं — mcp-remote तर्कों को व्हाइटस्पेस पर विभाजित करता है, इसलिए "Authorization: Bearer …" हेडर को तोड़ता है। फ़ाइल संपादित करने के बाद क्लाइंट को पूरी तरह पुनः आरंभ करें।

सर्वर जोड़ने के बाद, एजेंट से टूल्स सूचीबद्ध करने के लिए कहें। आपको search_tools, get_top_tools, get_tool, list_categories, list_tags, search_directories, get_directory, और list_directory_categories देखना चाहिए।

सत्यापित करें

curl -s https://www.aidirectori.es/api/mcp -X POST \
  -H "Authorization: Bearer aid_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

MCP / टूल्स

MCP टूल्स

हर MCP टूल REST कैटलॉग पर एक पतला आवरण है।

प्रमाणीकरण REST के समान Bearer aid_ कुंजी है।

टूलRESTइनपुट
search_toolsGET /toolsq, category, tag, pricing, featured, page, limit
get_top_toolsGET /tools/toplimit, category
get_toolGET /tools/{slug}slug
list_categoriesGET /categoriesq, limit
list_tagsGET /tagsq, limit
search_directoriesGET /directoriesq, category, cost, featured, page, limit
get_directoryGET /directories/{slug}slug
list_directory_categoriesGET /directory-categories—

पूर्ण फ़ील्ड नोट्स AI टूल्स और डायरेक्ट्री के अंतर्गत हैं।

REST API / अवलोकन

REST API

स्क्रिप्ट, CI, और पार्टनर एकीकरण के लिए सादा HTTP। MCP सर्वर इन्हीं पथों को कॉल करता है — इसलिए परिणाम कभी भी इस बात पर निर्भर नहीं करता कि किस ट्रांसपोर्ट ने इसे माँगा।

संचालनविधिपथप्रमाणीकरणइनपुट
search_tools वैकल्पिक श्रेणी, टैग, मूल्य निर्धारण, और फ़ीचर्ड फ़िल्टर के साथ कीवर्ड खोज।GET/toolsBearerq, category, tag, pricing, featured, includeAdult, page, limit
get_top_tools ओपन्स द्वारा शीर्ष N लिस्टिंग — कोई कीवर्ड आवश्यक नहीं।GET/tools/topBearerlimit, category, includeAdult
list_categories टूल गणना के साथ AI टूल श्रेणियाँ — खोज फ़िल्टर करने से पहले उपयोग करें।GET/categoriesBearerq, limit
list_tags टूल गणना के साथ AI टूल टैग।GET/tagsBearerq, limit
get_tool एक AI टूल के लिए पूर्ण सार्वजनिक लिस्टिंग।GET/tools/{slug}Bearerslug
search_directories नाम, श्रेणी, या लागत द्वारा सबमिशन डायरेक्ट्री खोजें।GET/directoriesBearerq, category, cost, featured, page, limit
get_directory एक डायरेक्ट्री के लिए पूर्ण सार्वजनिक प्रोफ़ाइल।GET/directories/{slug}Bearerslug
list_directory_categories फ़िल्टर खोज के लिए डायरेक्ट्री श्रेणी लेबल।GET/directory-categoriesBearer—
submit_ai_tool एक AI टूल लिस्टिंग बनाएँ (और वैकल्पिक रूप से डायरेक्ट्री सबमिशन कतारबद्ध करें)।POST/submit-ai-toolX-API-Keyname, website, tagline, description, category, pricing, founderName, founderEmail, tags, paymentType, …
get_tool_status आपकी कुंजी द्वारा सबमिट किए गए टूल के लिए डायरेक्ट्री-सबमिशन प्रगति पोल करें।GET/ai-tools/statusX-API-Keyid | slug | website

खोज GET / पर और OpenAPI दस्तावेज़ GET /openapi.json पर रहता है। कैटलॉग प्रतिक्रियाओं के लिए फ़ील्ड नोट्स AI टूल्स और डायरेक्ट्री पर हैं।

लिफ़ाफ़ा, पेजिनेशन, और सीमाएँ

हर प्रतिक्रिया एक ही लिफ़ाफ़ा है। data खोजों पर एक सरणी है और एकल-आइटम लुकअप पर एक वस्तु है। data पढ़ने से पहले success जाँचें।

{ "success": true, "data": [], "pagination": { "page": 1, "limit": 20, "total": 0, "pages": 0 } }

{ "success": false, "error": "Invalid or revoked API key." }

GET /tools और GET /directories एक pagination वस्तु लौटाते हैं। वर्गीकरण एंडपॉइंट — /categories, /tags, /directory-categories — पूरी सूची लौटाते हैं और कोई pagination कुंजी बिल्कुल नहीं।

pageआपको मिला पृष्ठ, 1-आधारित
limitवास्तव में लागू प्रति पृष्ठ आइटम
totalसभी पृष्ठों में मेल खाने वाले आइटम
pagesceil(total / limit), या 0 जब कुछ मेल नहीं खाता

एक अत्यधिक बड़ी सीमा क्लैम्प की जाती है, अस्वीकार नहीं। अधिकतम से अधिक माँगें और आपको अधिकतम मिलता है, 200 के साथ — कोई त्रुटि आपको नहीं बताती कि यह हुआ। /tools और /directories डिफ़ॉल्ट 20 और अधिकतम 100; /categories और /tags अधिकतम 500। एक अनुपस्थित, शून्य, नकारात्मक, या गैर-संख्यात्मक limit डिफ़ॉल्ट पर वापस आ जाता है, और page 1 पर फ़्लोर होता है। इसलिए प्रतिक्रिया से pagination.limit वापस पढ़ें, यह मानने के बजाय कि आपको माँगा गया पृष्ठ आकार मिला — वही धारणा पेजिंग लूप को अनंत लूप में बदल देती है।

page=1
while :; do
  body=$(curl -s "https://www.aidirectori.es/api/v1/tools?limit=100&page=$page" \
    -H "Authorization: Bearer $AID_KEY")
  echo "$body" | jq -e '.success' >/dev/null || { echo "$body"; break; }
  echo "$body" | jq -c '.data[]'
  pages=$(echo "$body" | jq '.pagination.pages')
  [ "$page" -ge "$pages" ] && break
  page=$((page + 1))
  sleep 6   # stay under 10 req/min on a standard key
done

AI टूल्स

लाइव कैटलॉग ब्राउज़ करें, खोजें, और फ़िल्टर करें, या स्लग द्वारा एक लिस्टिंग प्राप्त करें। MCP search_tools, get_top_tools, get_tool, list_categories, और list_tags से मैप करता है।

list_categories

टूल गणना के साथ AI टूल श्रेणियाँ — खोज फ़िल्टर करने से पहले उपयोग करें।

RESTGET /categories
MCPtools/call → list_categories
प्रमाणीकरणBearer
इनपुटq, limit
curl -s "https://www.aidirectori.es/api/v1/categories" \
  -H "Authorization: Bearer aid_your_api_key"

get_top_tools

ओपन्स द्वारा शीर्ष N लिस्टिंग — कोई कीवर्ड आवश्यक नहीं।

RESTGET /tools/top
MCPtools/call → get_top_tools
प्रमाणीकरणBearer
इनपुटlimit, category, includeAdult
curl -s "https://www.aidirectori.es/api/v1/tools/top?limit=10&category=image" \
  -H "Authorization: Bearer aid_your_api_key"

search_tools

वैकल्पिक श्रेणी, टैग, मूल्य निर्धारण, और फ़ीचर्ड फ़िल्टर के साथ कीवर्ड खोज।

RESTGET /tools
MCPtools/call → search_tools
प्रमाणीकरणBearer
इनपुटq, category, tag, pricing, featured, includeAdult, page, limit
curl -s "https://www.aidirectori.es/api/v1/tools?q=ai&limit=5" \
  -H "Authorization: Bearer aid_your_api_key"

get_tool

एक AI टूल के लिए पूर्ण सार्वजनिक लिस्टिंग।

RESTGET /tools/{slug}
MCPtools/call → get_tool
प्रमाणीकरणBearer
इनपुटslug
curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
  -H "Authorization: Bearer aid_your_api_key"

list_tags

टूल गणना के साथ AI टूल टैग।

RESTGET /tags
MCPtools/call → list_tags
प्रमाणीकरणBearer
इनपुटq, limit
curl -s "https://www.aidirectori.es/api/v1/tags" \
  -H "Authorization: Bearer aid_your_api_key"

डायरेक्ट्री

सबमिशन-डायरेक्ट्री कैटलॉग — Domain Rating, लागत, बैज, और श्रेणियाँ। MCP search_directories, get_directory, और list_directory_categories से मैप करता है।

search_directories

नाम, श्रेणी, या लागत द्वारा सबमिशन डायरेक्ट्री खोजें।

RESTGET /directories
MCPtools/call → search_directories
प्रमाणीकरणBearer
इनपुटq, category, cost, featured, page, limit
curl -s "https://www.aidirectori.es/api/v1/directories?cost=Free&limit=10" \
  -H "Authorization: Bearer aid_your_api_key"

get_directory

एक डायरेक्ट्री के लिए पूर्ण सार्वजनिक प्रोफ़ाइल।

RESTGET /directories/{slug}
MCPtools/call → get_directory
प्रमाणीकरणBearer
इनपुटslug
curl -s "https://www.aidirectori.es/api/v1/directories/theres-an-ai-for-that" \
  -H "Authorization: Bearer aid_your_api_key"

list_directory_categories

फ़िल्टर खोज के लिए डायरेक्ट्री श्रेणी लेबल।

RESTGET /directory-categories
MCPtools/call → list_directory_categories
प्रमाणीकरणBearer
इनपुट—
curl -s "https://www.aidirectori.es/api/v1/directory-categories" \
  -H "Authorization: Bearer aid_your_api_key"

पार्टनर

लेखन और स्थिति एंडपॉइंट को जारी की गई X-API-Key की आवश्यकता होती है। इसे अपने सर्वर पर रखें। MCP इन्हें कॉल नहीं करता। पूर्ण फ़ील्ड सूचियाँ सबमिट और पार्टनर के अंतर्गत हैं।

submit_ai_tool

एक AI टूल लिस्टिंग बनाएँ (और वैकल्पिक रूप से डायरेक्ट्री सबमिशन कतारबद्ध करें)।

RESTPOST /submit-ai-tool
MCP—
AuthX-API-Key
Inputname, website, tagline, description, category, pricing, founderName, founderEmail, tags, paymentType, …
curl -s -X POST "https://www.aidirectori.es/api/v1/submit-ai-tool" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Tool",
    "website": "https://mytool.com",
    "tagline": "One-line pitch",
    "description": "What the product does.",
    "category": "productivity",
    "pricing": "FREE",
    "paymentType": "pro",
    "founderName": "Jane Founder",
    "founderEmail": "jane@mytool.com",
    "tags": ["ai", "productivity"],
    "icon": "https://mytool.com/icon.png",
    "frame": "https://mytool.com/screenshot.png",
    "screenshots": ["https://mytool.com/gallery-1.png"]
  }'

get_tool_status

अपनी कुंजी से सबमिट किए गए टूल के लिए निर्देशिका-सबमिशन प्रगति की जाँच करें।

RESTGET /ai-tools/status
MCP—
AuthX-API-Key
Inputid | slug | website
curl -s "https://www.aidirectori.es/api/v1/ai-tools/status?slug=my-ai-tool" \
  -H "X-API-Key: YOUR_API_KEY"

REST API / AI टूल्स

AI टूल्स

प्रकाशित AI टूल सूचियों को ब्राउज़ करें, खोजें, और प्राप्त करें।

search_tools

श्रेणी, टैग, मूल्य निर्धारण, और फ़ीचर्ड फ़िल्टर के साथ कीवर्ड खोज।

RESTGET /tools
MCPsearch_tools
AuthBearer aid_
Inputq, category, tag, pricing (FREE | FREEMIUM | PAID), featured, includeAdult, page, limit (अधिकतम 100)
curl -s "https://www.aidirectori.es/api/v1/tools?q=transclipper&limit=5" \
  -H "Authorization: Bearer aid_your_api_key"

प्रत्येक आइटम में name, slug, listing URL, website, tagline, description, category, tags, pricing, rating, opens, icon, और timestamps शामिल हैं। कोई founder email नहीं।

वयस्क सूचियाँ डिफ़ॉल्ट रूप से बाहर रखी जाती हैं। search_tools और get_top_tools वयस्क सूचियों को तब तक रोकते हैं जब तक आप उन्हें नहीं माँगते।

बहिष्करण श्रेणी और टैग द्वारा है, क्योंकि वयस्क टूल अक्सर एक सामान्य श्रेणी — image, writing, video — के तहत दर्ज किए जाते हैं, जबकि वे स्वयं को सटीक रूप से टैग करते हैं। इसलिए category=image छवि टूल लौटाता है बिना undressing ऐप्स के।

ऑप्ट-इन करने के तीन तरीके: includeAdult=true, category=nsfw, या tag=ai-undressing जैसे वयस्क टैग का नाम देना। कुछ भी छिपा या अप्राप्य नहीं है — यह केवल वही नहीं है जो आपको तब मिलता है जब आपने नहीं पूछा।

get_top_tools

सबसे अधिक खोले गए प्रकाशित टूल। वैकल्पिक श्रेणी slug।

curl -s "https://www.aidirectori.es/api/v1/tools/top?limit=10&category=image" \
  -H "Authorization: Bearer aid_your_api_key"

get_tool

पूर्ण सार्वजनिक सूची: स्क्रीनशॉट, FAQs, सोशल्स, फ़ीचर्स।

curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
  -H "Authorization: Bearer aid_your_api_key"

list_categories / list_tags

curl -s "https://www.aidirectori.es/api/v1/categories" -H "Authorization: Bearer aid_your_api_key"
curl -s "https://www.aidirectori.es/api/v1/tags?q=photo" -H "Authorization: Bearer aid_your_api_key"

श्रेणियाँ slug, name, description, icon, toolsCount लौटाती हैं। टैग slug, name, toolsCount लौटाते हैं। कोई भी paginated नहीं है — आपको पूरी सूची मिलती है, इसलिए इसे कैश करें और स्थानीय रूप से फ़िल्टर करें।

टूल फ़ील्ड्स

/tools, /tools/top और /tools/{slug} द्वारा समान रूप से लौटाए गए:

फ़ील्डप्रकारनोट्स
idstringस्थिर पहचानकर्ता
slugstring/tools/{slug} के लिए इसका उपयोग करें
name, tagline, descriptionstring
urlstringaidirectori.es पर सूची
websitestringउत्पाद की अपनी साइट
categoryobject{ slug, name }, या null
tagsarray[{ slug, name }]
pricingstringFREE | FREEMIUM | PAID
ratingnumberबिना रेटिंग होने पर 0
opensnumberक्लिक-थ्रू; /tools/top इसी से क्रमबद्ध करता है
featuredboolean
icon, framestringछवि URLs, nullable
founderName, locationstringNullable। कोई founder email, कभी नहीं
domainRatingnumberNullable
isForSale, askingPriceboolean, numberअधिग्रहण के लिए चिह्नित सूचियाँ
discountCode, affiliatestring, boolean
createdAt, updatedAtstringISO 8601, nullable

GET /tools/{slug} screenshots (URLs की array), video, socials, faqs, features, और affiliateLink जोड़ता है। वे छह केवल एकल-टूल एंडपॉइंट पर हैं — उन्हें खोज से अपेक्षा न करें।

कोई भी फ़ील्ड null हो सकती है जब किसी सूची ने उसे नहीं भरा हो। रक्षात्मक रूप से कोड करें।

REST API / निर्देशिकाएँ

निर्देशिकाएँ

कैटलॉग का दूसरा आधा — स्टार्टअप और SaaS सबमिशन निर्देशिकाएँ, DR और मूल्य निर्धारण के साथ।

स्क्रेपर्स आमतौर पर इसे चूक जाते हैं। यह वह सूची है जिसमें हम वास्तव में उत्पाद सबमिट करते हैं।

search_directories

RESTGET /directories
MCPsearch_directories
AuthBearer aid_
Inputq, category, cost (Free | Paid | Freemium), featured, page, limit
curl -s "https://www.aidirectori.es/api/v1/directories?cost=Free&limit=10" \
  -H "Authorization: Bearer aid_your_api_key"

फ़ील्ड्स में name, listing URL, website, Domain Rating, मासिक विज़िट, लिंक प्रकार, बैज आवश्यकता, न्यूनतम मूल्य, और श्रेणियाँ शामिल हैं।

get_directory

विवरण, FAQ, सबमिशन लिंक, और डील कॉपी जोड़ता है।

curl -s "https://www.aidirectori.es/api/v1/directories/theres-an-ai-for-that" \
  -H "Authorization: Bearer aid_your_api_key"

list_directory_categories

curl -s "https://www.aidirectori.es/api/v1/directory-categories" \
  -H "Authorization: Bearer aid_your_api_key"

केवल slug और name लौटाता है। Paginated नहीं। ये वे मान हैं जिन्हें ?category= स्वीकार करता है — अनुमान लगाने के बजाय उन्हें पढ़ें।

निर्देशिका फ़ील्ड्स

फ़ील्डप्रकारनोट्स
id, slug, namestring
urlstringaidirectori.es पर प्रोफ़ाइल
websitestringनिर्देशिका की अपनी साइट
iconstringNullable
coststringFree | Paid | Freemium
typestringलिंक प्रकार
domainRatingnumberNullable — वह संख्या जिस पर अधिकांश लोग क्रमबद्ध करते हैं
monthlyVisitsnumberNullable
requiresBadgebooleanक्या वे बैकलिंक बैज की माँग करते हैं
minimumPricenumberमुफ्त होने पर 0
submissionExperiencestringNullable
featuredboolean
categoriesarray[{ slug, name }]
smallDescriptionstringNullable
createdAt, updatedAtstringISO 8601

GET /directories/{slug} fullDescription, features, useCases, faq, deal ({ text, code } या null), frame, और socials जोड़ता है।

दो url फ़ील्ड्स पर ध्यान दें: url हमारा प्रोफ़ाइल पृष्ठ है, website निर्देशिका स्वयं है। प्रत्यक्ष सबमिशन फ़ॉर्म URLs (submissionLink) नहीं हैं कैटलॉग API या MCP में — वे साइट और डैशबोर्ड पर भुगतान किए गए सूची उत्पाद का हिस्सा हैं।

सबमिशन लक्ष्य चुनना

curl -s "https://www.aidirectori.es/api/v1/directories?cost=Free&limit=100" \
  -H "Authorization: Bearer $AID_KEY" \
  | jq -r '.data
      | map(select(.requiresBadge == false and .domainRating != null))
      | sort_by(-.domainRating)
      | .[]
      | [.domainRating, .name, .website] | @tsv'

मुफ्त, कोई बैज आवश्यक नहीं, पहले सबसे मजबूत डोमेन।

REST API / सबमिट और पार्टनर्स

सबमिट और पार्टनर्स

टूल सबमिट करने, स्थिति पोल करने, वेबहुक, और समर्थन के लिए API-कुंजी एंडपॉइंट्स।

ये अनाम नहीं हैं। हम प्रति पार्टनर एक कुंजी जारी करते हैं। MCP इन्हें कॉल नहीं करता।

एक टूल सबमिट करें

POST https://www.aidirectori.es/api/v1/submit-ai-tool

एक सूची बनाता है। उस पैकेज के लिए निर्देशिका सबमिशन कतारबद्ध करने के लिए paymentType भेजें। इसे छोड़ दें और टूल प्रतीक्षा के रूप में बनाया जाता है ताकि पैकेज बाद में एडमिन में सेट किया जा सके।

आवश्यक

9

इनमें से कोई भी गायब होने पर 400 लौटता है।

फ़ील्डप्रकारनोट्स

  • name string अधिकतम 100 वर्ण।
  • website url उत्पाद का सार्वजनिक URL।
  • tagline string अधिकतम 200 वर्ण।
  • description string उत्पाद क्या करता है।
  • category string Slug या नाम। हम इसे मौजूदा श्रेणी पर मैप करते हैं।
  • pricing enum FREE PAID FREEMIUM उत्पाद की अपनी मूल्य निर्धारण — निर्देशिका पैकेज नहीं।
  • founderName string आप इसे POST से पहले एकत्र करते हैं।
  • founderEmail email आप इसे एकत्र करते हैं। सार्वजनिक कैटलॉग रीड पर कभी नहीं लौटाया जाता। ब्राउज़र से न भेजें।
  • tags string[] Slugs या नाम।

अनुशंसित

5

इनके बिना अनुरोध सफल होता है — हम एक slug उत्पन्न करते हैं, icon/og:image प्राप्त करते हैं, और पैकेज को प्रतीक्षा के रूप में छोड़ देते हैं। जब आपके पास हों तो भेजें।

फ़ील्डप्रकारनोट्स

  • paymentType enum starter pro premium निर्देशिका पैकेज: 30+, 60+, या 100+ सबमिशन। यदि ग्राहक ने पहले ही पैकेज चुना है तो इसे भेजें। केवल तभी छोड़ें यदि आप चाहते हैं कि टूल प्रतीक्षा के रूप में बनाया जाए ताकि एडमिन इसे बाद में सेट कर सके।
  • slug string सार्वजनिक URL slug। नाम से उत्पन्न (और अद्वितीय) यदि छोड़ा गया — इसे भेजें जब आपके पास पहले से स्थिर slug हो।
  • icon url वर्गाकार लोगो। यदि छोड़ा गया, हम साइट favicon प्राप्त करते हैं — बेहतर सूची के लिए अपना भेजें।
  • frame url मुख्य स्क्रीनशॉट। यदि छोड़ा गया, हम og:image प्राप्त करते हैं — जब आपके पास हो तो उत्पाद शॉट भेजें।
  • screenshots url[] गैलरी छवियाँ, Cloudflare पर मिरर की गईं। आवश्यक नहीं; यदि यह खाली है तो फ़्रेम हीरो को कवर करता है।

वैकल्पिक

11

सार्वजनिक URLs पर छवियाँ Cloudflare पर मिरर की जाती हैं।

फ़ील्डप्रकारनोट्स

  • video url YouTube या Vimeo।
  • socials object URLs की कुंजियाँ, जैसे { "twitter": "https://x.com/…" }।
  • features object स्ट्रिंग मैप, जैसे { "Templates": "50+" }। छोड़े जाने पर उत्पन्न।
  • faq array यदि छोड़ा गया, साइट से स्क्रैप किया गया या उत्पन्न।
  • affiliate string सहबद्ध कार्यक्रम कॉपी।
  • affiliateLink url
  • discountCode string सूची पर दिखाया गया प्रोमो कोड।
  • location string कंपनी कहाँ आधारित है।
  • foundingDate string स्थापना तिथि, मुक्त-रूप।
  • isCustomer boolean क्या वे पहले से ग्राहक हैं।
  • isLaunched boolean क्या उत्पाद लाइव है।
curl -s -X POST "https://www.aidirectori.es/api/v1/submit-ai-tool" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Tool",
    "website": "https://mytool.com",
    "tagline": "One-line pitch",
    "description": "What the product does.",
    "category": "productivity",
    "pricing": "FREE",
    "paymentType": "pro",
    "founderName": "Jane Founder",
    "founderEmail": "jane@mytool.com",
    "tags": ["ai", "productivity"],
    "icon": "https://mytool.com/icon.png",
    "frame": "https://mytool.com/screenshot.png",
    "screenshots": ["https://mytool.com/gallery-1.png"]
  }'

सबमिशन स्थिति पोल करें

GET https://www.aidirectori.es/api/v1/ai-tools/status — अपनी कुंजी से सबमिट किए गए टूल को id, slug, या website में से ठीक एक के साथ देखें। अन्य क्लाइंट के टूल 404 लौटाते हैं।

इसे कभी भी उपयोग करें — केवल तब नहीं जब वेबहुक फायर हो। पोल करें जबकि summary.isComplete false है, फिर रुकें (या Done की प्रतीक्षा करें)। submissionState IN_QUEUE, ASSIGNED, IN_PROGRESS, REVIEW, DONE, या null है जब कोई निर्देशिका वर्कफ़्लो नहीं है।

curl -s "https://www.aidirectori.es/api/v1/ai-tools/status?slug=my-ai-tool" \
  -H "X-API-Key: YOUR_API_KEY"

वेबहुक

हम आपके API क्लाइंट पर संग्रहीत HTTPS URL पर JSON POST करते हैं — प्रत्येक सबमिट पर नहीं भेजा जाता। आवेदन करते समय हमें URL दें; हम इसे webhookUrl के रूप में संग्रहीत करते हैं और आपको एक हस्ताक्षर गोपनीयता भेजते हैं। दोनों निर्देशिका-Done और समर्थन उत्तर उसी एंडपॉइंट पर हिट होते हैं।

निर्देशिका घटना तब फायर होती है जब एडमिन आपकी कुंजी से सबमिट किए गए टूल पर Done क्लिक करता है और webhookUrl सेट है। URL गायब: हम कुछ नहीं भेजते। आपका एंडपॉइंट डाउन या गैर-2xx: टूल अभी भी Done चिह्नित है। हम अभी retry नहीं करते — यदि आपको फ़ॉलबैक चाहिए तो स्थिति पोल करें।

घटनाएँ

2

बॉडी पार्स करने से पहले X-AI-Directories-Event पढ़ें।

फ़ील्डप्रकारनोट्स

  • directory_submissions.completed Done एडमिन ने आपकी कुंजी से सबमिट किए गए टूल के लिए निर्देशिका कार्य Done चिह्नित किया। Payload { event, occurredAt, tool, summary, submissions } है।
  • support.replied reply एक समर्थन उत्तर तैयार है (AI या मानव)। Payload { event, occurredAt, conversation } है। केवल यदि समर्थन सक्षम है।

अनुरोध

विधिPOST
Content-Typeapplication/json
AuthHMAC हेडर — आपकी API कुंजी नहीं

हेडर

3

फ़ील्डप्रकारनोट्स

  • X-AI-Directories-Event string आपको कौन सा payload मिला। इस पर शाखा करें — समान URL दोनों घटनाएँ प्राप्त करता है।
  • X-AI-Directories-Signature string sha256=<hex> आपके हस्ताक्षर गोपनीयता के साथ कच्चे बॉडी का HMAC। मौजूद जब हमने एक गोपनीयता जारी की।
  • User-Agent string AI-Directories-Webhook/1.0

हस्ताक्षर सत्यापित करें

HMAC-SHA256 कच्चे अनुरोध बॉडी पर उस गोपनीयता के साथ जो हमने आपको दी। हेक्स डाइजेस्ट की तुलना X-AI-Directories-Signature से करें sha256= उपसर्ग हटाने के बाद। समय-सुरक्षित तुलना का उपयोग करें।

const crypto = require("crypto");

function verifySignature(rawBody, signatureHeader, secret) {
  const expected = crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
  const received = String(signatureHeader || "").replace(/^sha256=/, "");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received));
}

Payload

submissions केवल उन निर्देशिकाओं को शामिल करता है जिन्हें हमने वास्तव में सबमिट किया। प्रत्येक पंक्ति में लाइव listingUrl, प्रमाण स्क्रीनशॉट, डोमेन रेटिंग, और किसने सबमिट किया (ADMIN या OWNER) शामिल हो सकता है। स्वीकार करने के लिए 2xx लौटाएँ।

{
  "event": "directory_submissions.completed",
  "occurredAt": "2026-09-01T13:00:00.000Z",
  "tool": {
    "id": "64a1b2c3d4e5f6789012345",
    "name": "My AI Tool",
    "slug": "my-ai-tool",
    "website": "https://myaitool.com",
    "paymentStatus": "prolist",
    "paymentLabel": "Pro · 60+",
    "targetDirectoriesCount": 60
  },
  "summary": {
    "submittedCount": 62,
    "recordedSubmissions": 62,
    "notes": "All high-DR directories completed"
  },
  "submissions": [
    {
      "name": "There's An AI For That",
      "slug": "theres-an-ai-for-that",
      "url": "https://theresanaiforthat.com",
      "listingUrl": "https://theresanaiforthat.com/ai/my-ai-tool",
      "domainRating": 81,
      "isSubmitted": true,
      "submittedBy": "ADMIN",
      "submittedAt": "2026-09-01T12:00:00.000Z"
    }
  ]
}

ग्राहक समर्थन

अपने उत्पाद UI से एक प्रश्न अग्रेषित करें; हम आपके ज्ञान आधार से उत्तर देते हैं जब हम कर सकते हैं, या एक मानव हमारे डैशबोर्ड में उत्तर देता है। डिफ़ॉल्ट रूप से बंद — जब तक हम इसे सक्षम नहीं करते, POST /support/ask 403 लौटाता है। सबमिट के समान X-API-Key। MCP इसे कॉल नहीं कर सकता।

डिफ़ॉल्ट मोड हाइब्रिड है: AI उत्तर देता है जब यह कर सकता है, अन्यथा बातचीत मानव के लिए pending रहती है। हम क्लाइंट को मानव-केवल (कोई AI नहीं) पर सेट कर सकते हैं। उत्पाद ज्ञान के बिना, प्रश्न एक व्यक्ति की प्रतीक्षा करते हैं।

एक प्रश्न भेजें

POST https://www.aidirectori.es/api/v1/support/ask

बॉडी

5 question आवश्यक है। थ्रेड जारी रखने के लिए conversationId या externalId का पुनः उपयोग करें। केवल मानव-क्लाइंट idempotent retries के लिए metadata.peerPushMessageId भेज सकते हैं।

FieldTypeNotes

  • question string ग्राहक का प्रश्न। अधिकतम 4000 वर्ण। message भी स्वीकार्य है।
  • conversationId string पहले लौटाए गए थ्रेड को जारी रखें।
  • externalId string आपका टिकट या थ्रेड आईडी। इसका पुनः उपयोग करने से वही वार्तालाप जारी रहता है।
  • customer object अंतिम ग्राहक के लिए वैकल्पिक { name, email, id } — submit से founder के लिए नहीं।
  • metadata object वार्तालाप पर संग्रहीत मनमाना JSON।
curl -s -X POST "https://www.aidirectori.es/api/v1/support/ask" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "How do I cancel my subscription?",
    "externalId": "ticket-123",
    "customer": { "name": "Ada", "email": "ada@example.com" }
  }'

हाइब्रिड/AI: 200 के साथ status: "answered" का अर्थ है कि reply तैयार है (replySource ai या human है)। pending का अर्थ है poll करें या webhook की प्रतीक्षा करें।

{
  "success": true,
  "data": {
    "id": "64a1b2c3d4e5f6789012345",
    "status": "answered",
    "externalId": "ticket-123",
    "reply": "You can cancel from Settings → Billing.",
    "replySource": "ai",
    "messages": [
      { "role": "customer", "content": "How do I cancel my subscription?" },
      { "role": "assistant", "content": "You can cancel from Settings → Billing.", "source": "ai" }
    ]
  }
}

केवल मानव-क्लाइंट को पतला envelope मिलता है — कोई इतिहास नहीं, customer, या messages[]। message null है जब तक कोई मानव उत्तर नहीं देता, फिर एकल agent संदेश।

{
  "success": true,
  "data": {
    "id": "64a1b2c3d4e5f6789012345",
    "externalId": "ticket-123",
    "status": "pending",
    "message": null
  }
}

वार्तालाप को poll करें

GET https://www.aidirectori.es/api/v1/support/conversations/:id — या ?id=, ?externalId=, या ?status=pending के साथ सूची बनाएं। लंबित रहते हुए सुझाया गया अंतराल: 5–15 सेकंड। हाइब्रिड सूची परिणाम पूर्ण messages array को छोड़ देते हैं; केवल मानव-क्लाइंट ask के समान पतला आकार लौटाता है।

curl -s "https://www.aidirectori.es/api/v1/support/conversations/64a1b2c3d4e5f6789012345" \
  -H "X-API-Key: YOUR_API_KEY"

उत्तर तैयार होने पर Webhook

यदि webhookUrl सेट है, तो हम support.replied POST करते हैं — directory Done के समान HMAC। हाइब्रिड/AI payload reply / replySource का उपयोग करता है। केवल मानव-क्लाइंट conversation.message के साथ एकवचन role: "agent" और source: "human" का उपयोग करता है।

{
  "event": "support.replied",
  "occurredAt": "2026-09-09T09:01:00.000Z",
  "conversation": {
    "id": "64a1b2c3d4e5f6789012345",
    "status": "answered",
    "externalId": "ticket-123",
    "reply": "You can cancel from Settings → Billing.",
    "replySource": "human"
  }
}
{
  "event": "support.replied",
  "occurredAt": "2026-09-11T12:00:00.000Z",
  "conversation": {
    "id": "64a1b2c3d4e5f6789012345",
    "externalId": "ticket-123",
    "status": "answered",
    "message": {
      "id": "...",
      "role": "agent",
      "source": "human",
      "content": "Thanks — here's how to cancel…",
      "createdAt": "2026-09-11T12:00:00.000Z"
    }
  }
}

कुंजी, webhook URL, signing secret, या समर्थन पहुंच के लिए support@thedirectori.es पर ईमेल करें — या Got a directory? से आवेदन करें।

Reference / Rate limits

Rate limits

मानक कुंजियों को प्रति मिनट 10 अनुरोध मिलते हैं। प्रीमियम कुंजियों को 60। हर प्रतिक्रिया पर हेडर।

सीमाएँ प्रति API कुंजी हैं, प्रति IP नहीं — और REST और MCP अलग बजट से लेते हैं, इसलिए agent का विस्फोट आपके सर्वर-साइड स्क्रिप्ट को भूखा नहीं छोड़ सकता।

कुंजीREST / मिनटMCP / मिनट
मानक (डैशबोर्ड से aid_)1030
प्रीमियम (भुगतान किया गया Catalog API प्लान, admin अनुदान, या जारी की गई partner कुंजी)60120

MCP बजट बड़ा है क्योंकि agents फैलते हैं: उपयोगकर्ता का एक प्रश्न नियमित रूप से कई समानांतर tool कॉल बन जाता है।

हैंडशेक मुफ्त है

initialize, notifications/initialized, ping, और tools/list की कोई लागत नहीं है। क्लाइंट को जोड़ना, या उसे पुनः आरंभ करना, आपका कोटा खर्च नहीं करता — केवल tools/call करता है। गलत अनुरोध निकाय भी शुल्क नहीं लेता।

हर प्रतिक्रिया में X-RateLimit-Limit, X-RateLimit-Remaining, और X-RateLimit-Reset शामिल हैं। 429 भी Retry-After भेजता है।

अपने developer डैशबोर्ड से अपग्रेड करें ($9/माह)। कैटलॉग डंप करने के लिए खोज-इंजन या सहायक क्रॉलर का रूप धारण न करें।

अधिक सीमा चाहिए? support@thedirectori.es पर ईमेल करें।

Partner submit/support कुंजियों की अपनी लेखन सीमाएँ हैं; पढ़ते समय वे प्रीमियम कैटलॉग बजट का उपयोग करती हैं।

Reference / Errors

Errors

JSON त्रुटि आकार और HTTP स्थिति कोड।

{ "success": false, "error": "Tool not found." }
HTTPअर्थ
400गलत अनुरोध
401API कुंजी गायब या अमान्य
403कुंजी मान्य है लेकिन सुविधा सक्षम नहीं है
404Tool, directory, या वार्तालाप नहीं मिला
429Rate limit
500 / 503सर्वर या डेटाबेस समस्या — पुनः प्रयास करें

MCP JSON-RPC त्रुटियों का उपयोग करता है (-32601 method नहीं मिला, -32603 आंतरिक, और tool isError payloads)।