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
API और MCP
आधिकारिक AI Directories कैटलॉग — curl या किसी एजेंट से AI टूल्स और सबमिशन डायरेक्ट्री खोजें। मुफ्त, प्रलेखित, और स्क्रैपिंग से बेहतर।
RESTGET · Bearer aid_
MCPStreamable HTTP
OpenAPImachine spec
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"
]
}
}
}
मशीन-पठनीय भी
- /llms.txt — एजेंटों के लिए साइट संक्षिप्त विवरण
- /sitemap.xml
- 60 req/min · 400/hour प्रति IP
आरंभ करें / त्वरित आरंभ
त्वरित आरंभ
एक 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 अपनी API कुंजी प्राप्त करें
डेवलपर डैशबोर्ड पर जाएँ और एक API कुंजी बनाएँ। कुंजियाँaid_से शुरू होती हैं। इसे सुरक्षित रूप से संग्रहीत करें — आप पूर्ण कुंजी फिर से नहीं देख पाएँगे। स्वीकार्य उपयोग आवश्यक है कुंजी बनाने के लिए API स्वीकार्य उपयोग नीति से सहमति आवश्यक है। व्यवसायों की नकल करना, AI Directories का पुनर्निर्माण करना, थोक पुनर्प्रकाशन, अनधिकृत सार्वजनिक SEO पृष्ठ, दुरुपयोगी लक्ष्यीकरण, क्रेडेंशियल साझा करना, और पहुँच-नियंत्रण से बचना निषिद्ध है और स्थायी प्लेटफ़ॉर्म प्रतिबंध का परिणाम हो सकता है। -
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 प्रतिक्रिया पार्स करें
सफल पठन{ 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_tools | GET /tools | q, category, tag, pricing, featured, page, limit |
get_top_tools | GET /tools/top | limit, category |
get_tool | GET /tools/{slug} | slug |
list_categories | GET /categories | q, limit |
list_tags | GET /tags | q, limit |
search_directories | GET /directories | q, category, cost, featured, page, limit |
get_directory | GET /directories/{slug} | slug |
list_directory_categories | GET /directory-categories | — |
पूर्ण फ़ील्ड नोट्स AI टूल्स और डायरेक्ट्री के अंतर्गत हैं।
REST API / अवलोकन
REST API
स्क्रिप्ट, CI, और पार्टनर एकीकरण के लिए सादा HTTP। MCP सर्वर इन्हीं पथों को कॉल करता है — इसलिए परिणाम कभी भी इस बात पर निर्भर नहीं करता कि किस ट्रांसपोर्ट ने इसे माँगा।
| संचालन | विधि | पथ | प्रमाणीकरण | इनपुट |
|---|---|---|---|---|
| search_tools वैकल्पिक श्रेणी, टैग, मूल्य निर्धारण, और फ़ीचर्ड फ़िल्टर के साथ कीवर्ड खोज। | GET | /tools | Bearer | q, category, tag, pricing, featured, includeAdult, page, limit |
| get_top_tools ओपन्स द्वारा शीर्ष N लिस्टिंग — कोई कीवर्ड आवश्यक नहीं। | GET | /tools/top | Bearer | limit, category, includeAdult |
| list_categories टूल गणना के साथ AI टूल श्रेणियाँ — खोज फ़िल्टर करने से पहले उपयोग करें। | GET | /categories | Bearer | q, limit |
| list_tags टूल गणना के साथ AI टूल टैग। | GET | /tags | Bearer | q, limit |
| get_tool एक AI टूल के लिए पूर्ण सार्वजनिक लिस्टिंग। | GET | /tools/{slug} | Bearer | slug |
| search_directories नाम, श्रेणी, या लागत द्वारा सबमिशन डायरेक्ट्री खोजें। | GET | /directories | Bearer | q, category, cost, featured, page, limit |
| get_directory एक डायरेक्ट्री के लिए पूर्ण सार्वजनिक प्रोफ़ाइल। | GET | /directories/{slug} | Bearer | slug |
| list_directory_categories फ़िल्टर खोज के लिए डायरेक्ट्री श्रेणी लेबल। | GET | /directory-categories | Bearer | — |
| submit_ai_tool एक AI टूल लिस्टिंग बनाएँ (और वैकल्पिक रूप से डायरेक्ट्री सबमिशन कतारबद्ध करें)। | POST | /submit-ai-tool | X-API-Key | name, website, tagline, description, category, pricing, founderName, founderEmail, tags, paymentType, … |
| get_tool_status आपकी कुंजी द्वारा सबमिट किए गए टूल के लिए डायरेक्ट्री-सबमिशन प्रगति पोल करें। | GET | /ai-tools/status | X-API-Key | id | 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 | सभी पृष्ठों में मेल खाने वाले आइटम |
| pages | ceil(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 टूल श्रेणियाँ — खोज फ़िल्टर करने से पहले उपयोग करें।
| REST | GET /categories |
|---|---|
| MCP | tools/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 लिस्टिंग — कोई कीवर्ड आवश्यक नहीं।
| REST | GET /tools/top |
|---|---|
| MCP | tools/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
वैकल्पिक श्रेणी, टैग, मूल्य निर्धारण, और फ़ीचर्ड फ़िल्टर के साथ कीवर्ड खोज।
| REST | GET /tools |
|---|---|
| MCP | tools/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 टूल के लिए पूर्ण सार्वजनिक लिस्टिंग।
| REST | GET /tools/{slug} |
|---|---|
| MCP | tools/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 टूल टैग।
| REST | GET /tags |
|---|---|
| MCP | tools/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
नाम, श्रेणी, या लागत द्वारा सबमिशन डायरेक्ट्री खोजें।
| REST | GET /directories |
|---|---|
| MCP | tools/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
एक डायरेक्ट्री के लिए पूर्ण सार्वजनिक प्रोफ़ाइल।
| REST | GET /directories/{slug} |
|---|---|
| MCP | tools/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
फ़िल्टर खोज के लिए डायरेक्ट्री श्रेणी लेबल।
| REST | GET /directory-categories |
|---|---|
| MCP | tools/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 टूल लिस्टिंग बनाएँ (और वैकल्पिक रूप से डायरेक्ट्री सबमिशन कतारबद्ध करें)।
| REST | POST /submit-ai-tool |
|---|---|
| MCP | — |
| Auth | X-API-Key |
| Input | name, 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
अपनी कुंजी से सबमिट किए गए टूल के लिए निर्देशिका-सबमिशन प्रगति की जाँच करें।
| REST | GET /ai-tools/status |
|---|---|
| MCP | — |
| Auth | X-API-Key |
| Input | id | 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
श्रेणी, टैग, मूल्य निर्धारण, और फ़ीचर्ड फ़िल्टर के साथ कीवर्ड खोज।
| REST | GET /tools |
|---|---|
| MCP | search_tools |
| Auth | Bearer aid_ |
| Input | q, 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} द्वारा समान रूप से लौटाए गए:
| फ़ील्ड | प्रकार | नोट्स |
|---|---|---|
id | string | स्थिर पहचानकर्ता |
slug | string | /tools/{slug} के लिए इसका उपयोग करें |
name, tagline, description | string | |
url | string | aidirectori.es पर सूची |
website | string | उत्पाद की अपनी साइट |
category | object | { slug, name }, या null |
tags | array | [{ slug, name }] |
pricing | string | FREE | FREEMIUM | PAID |
rating | number | बिना रेटिंग होने पर 0 |
opens | number | क्लिक-थ्रू; /tools/top इसी से क्रमबद्ध करता है |
featured | boolean | |
icon, frame | string | छवि URLs, nullable |
founderName, location | string | Nullable। कोई founder email, कभी नहीं |
domainRating | number | Nullable |
isForSale, askingPrice | boolean, number | अधिग्रहण के लिए चिह्नित सूचियाँ |
discountCode, affiliate | string, boolean | |
createdAt, updatedAt | string | ISO 8601, nullable |
GET /tools/{slug} screenshots (URLs की array), video, socials, faqs, features, और affiliateLink जोड़ता है। वे छह केवल एकल-टूल एंडपॉइंट पर हैं — उन्हें खोज से अपेक्षा न करें।
कोई भी फ़ील्ड null हो सकती है जब किसी सूची ने उसे नहीं भरा हो। रक्षात्मक रूप से कोड करें।
REST API / निर्देशिकाएँ
निर्देशिकाएँ
कैटलॉग का दूसरा आधा — स्टार्टअप और SaaS सबमिशन निर्देशिकाएँ, DR और मूल्य निर्धारण के साथ।
स्क्रेपर्स आमतौर पर इसे चूक जाते हैं। यह वह सूची है जिसमें हम वास्तव में उत्पाद सबमिट करते हैं।
search_directories
| REST | GET /directories |
|---|---|
| MCP | search_directories |
| Auth | Bearer aid_ |
| Input | q, 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, name | string | |
url | string | aidirectori.es पर प्रोफ़ाइल |
website | string | निर्देशिका की अपनी साइट |
icon | string | Nullable |
cost | string | Free | Paid | Freemium |
type | string | लिंक प्रकार |
domainRating | number | Nullable — वह संख्या जिस पर अधिकांश लोग क्रमबद्ध करते हैं |
monthlyVisits | number | Nullable |
requiresBadge | boolean | क्या वे बैकलिंक बैज की माँग करते हैं |
minimumPrice | number | मुफ्त होने पर 0 |
submissionExperience | string | Nullable |
featured | boolean | |
categories | array | [{ slug, name }] |
smallDescription | string | Nullable |
createdAt, updatedAt | string | ISO 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 लौटता है।
फ़ील्डप्रकारनोट्स
namestring अधिकतम 100 वर्ण।websiteurl उत्पाद का सार्वजनिक URL।taglinestring अधिकतम 200 वर्ण।descriptionstring उत्पाद क्या करता है।categorystring Slug या नाम। हम इसे मौजूदा श्रेणी पर मैप करते हैं।pricingenumFREEPAIDFREEMIUMउत्पाद की अपनी मूल्य निर्धारण — निर्देशिका पैकेज नहीं।founderNamestring आप इसे POST से पहले एकत्र करते हैं।founderEmailemail आप इसे एकत्र करते हैं। सार्वजनिक कैटलॉग रीड पर कभी नहीं लौटाया जाता। ब्राउज़र से न भेजें।tagsstring[] Slugs या नाम।
अनुशंसित
5
इनके बिना अनुरोध सफल होता है — हम एक slug उत्पन्न करते हैं, icon/og:image प्राप्त करते हैं, और पैकेज को प्रतीक्षा के रूप में छोड़ देते हैं। जब आपके पास हों तो भेजें।
फ़ील्डप्रकारनोट्स
paymentTypeenumstarterpropremiumनिर्देशिका पैकेज: 30+, 60+, या 100+ सबमिशन। यदि ग्राहक ने पहले ही पैकेज चुना है तो इसे भेजें। केवल तभी छोड़ें यदि आप चाहते हैं कि टूल प्रतीक्षा के रूप में बनाया जाए ताकि एडमिन इसे बाद में सेट कर सके।slugstring सार्वजनिक URL slug। नाम से उत्पन्न (और अद्वितीय) यदि छोड़ा गया — इसे भेजें जब आपके पास पहले से स्थिर slug हो।iconurl वर्गाकार लोगो। यदि छोड़ा गया, हम साइट favicon प्राप्त करते हैं — बेहतर सूची के लिए अपना भेजें।frameurl मुख्य स्क्रीनशॉट। यदि छोड़ा गया, हम og:image प्राप्त करते हैं — जब आपके पास हो तो उत्पाद शॉट भेजें।screenshotsurl[] गैलरी छवियाँ, Cloudflare पर मिरर की गईं। आवश्यक नहीं; यदि यह खाली है तो फ़्रेम हीरो को कवर करता है।
वैकल्पिक
11
सार्वजनिक URLs पर छवियाँ Cloudflare पर मिरर की जाती हैं।
फ़ील्डप्रकारनोट्स
videourl YouTube या Vimeo।socialsobject URLs की कुंजियाँ, जैसे{ "twitter": "https://x.com/…" }।featuresobject स्ट्रिंग मैप, जैसे{ "Templates": "50+" }। छोड़े जाने पर उत्पन्न।faqarray यदि छोड़ा गया, साइट से स्क्रैप किया गया या उत्पन्न।affiliatestring सहबद्ध कार्यक्रम कॉपी।affiliateLinkurldiscountCodestring सूची पर दिखाया गया प्रोमो कोड।locationstring कंपनी कहाँ आधारित है।foundingDatestring स्थापना तिथि, मुक्त-रूप।isCustomerboolean क्या वे पहले से ग्राहक हैं।isLaunchedboolean क्या उत्पाद लाइव है।
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.completedDone एडमिन ने आपकी कुंजी से सबमिट किए गए टूल के लिए निर्देशिका कार्य Done चिह्नित किया। Payload { event, occurredAt, tool, summary, submissions } है।support.repliedreply एक समर्थन उत्तर तैयार है (AI या मानव)। Payload { event, occurredAt, conversation } है। केवल यदि समर्थन सक्षम है।
अनुरोध
| विधि | POST |
|---|---|
| Content-Type | application/json |
| Auth | HMAC हेडर — आपकी API कुंजी नहीं |
हेडर
3
फ़ील्डप्रकारनोट्स
X-AI-Directories-Eventstring आपको कौन सा payload मिला। इस पर शाखा करें — समान URL दोनों घटनाएँ प्राप्त करता है।X-AI-Directories-Signaturestring sha256=<hex> आपके हस्ताक्षर गोपनीयता के साथ कच्चे बॉडी का HMAC। मौजूद जब हमने एक गोपनीयता जारी की।User-Agentstring 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
questionstring ग्राहक का प्रश्न। अधिकतम 4000 वर्ण। message भी स्वीकार्य है।conversationIdstring पहले लौटाए गए थ्रेड को जारी रखें।externalIdstring आपका टिकट या थ्रेड आईडी। इसका पुनः उपयोग करने से वही वार्तालाप जारी रहता है।customerobject अंतिम ग्राहक के लिए वैकल्पिक{ name, email, id }— submit से founder के लिए नहीं।metadataobject वार्तालाप पर संग्रहीत मनमाना 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_) | 10 | 30 |
| प्रीमियम (भुगतान किया गया Catalog API प्लान, admin अनुदान, या जारी की गई partner कुंजी) | 60 | 120 |
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 | गलत अनुरोध |
| 401 | API कुंजी गायब या अमान्य |
| 403 | कुंजी मान्य है लेकिन सुविधा सक्षम नहीं है |
| 404 | Tool, directory, या वार्तालाप नहीं मिला |
| 429 | Rate limit |
| 500 / 503 | सर्वर या डेटाबेस समस्या — पुनः प्रयास करें |
MCP JSON-RPC त्रुटियों का उपयोग करता है (-32601 method नहीं मिला, -32603 आंतरिक, और tool isError payloads)।