# AI Agent Marketplace API Document AI Agent Marketplace is python/node packages to allow you to get access to AI Agent Card or Meta Information from open marketplace of various endpoints. It can be easily integrated in your LLM and AI application workflow, including Get, LIST, UPDATE , CREATE and DELETE method, which can also give user reviews, ratings and github stars and many metrics to allow LLM to choose wisely. ## [API V2](#api_v2) Get AI Agents meta information, statistics and more.. **GET** ```http GET /api/ai_agent_marketplace/v2?mode=list&query=coding agent&page_id=0&count_per_page=5 ``` **Curl** ```http curl 'https://www.deepnlp.org/api/ai_agent_marketplace/v2?mode=list&query=coding agent&page_id=0&count_per_page=5' ``` **Parameters** | Parameter | type | demo value | Description | |----------------|--------|---------------------------------------------------------|----------------------------------------------------| | query | string | /api/ai_agent_marketplace/v2?query=map | - | | - | string | /api/ai_agent_marketplace/v2? | - | | page_id | int | /api/ai_agent_marketplace/v2?page_id=0&count_per_page=5 | starting from 0 | | count_per_page | int | /api/ai_agent_marketplace/v2?page_id=0&count_per_page=5 | number of items per page | | offset | int | /api/ai_agent_marketplace/v2?offset=0 | total number offset, equals page_id*count_per_page | | mode | string | mode='list' or 'dict' | different output return type, list of dict | **Results** | Parameter | type | value | |---------------|--------|----------------------------------------------------------------------------------------| | total_hits | int | total hits of items | | count | int | the cound of items returned in this page, etc. | | items | string | the list of json object returned | | $.id | string | ID of AI Agent, format as {owner_id}/{content_name},e.g. 'demo-publisher/auto-agent-1' | | $.detail_url | string | Detail URL Webpage of AI Agent Card | | $.publisher_id | string | the owner_id of the AI Agent published with prefix 'pub-' | | $.content_name | string | the name of AI Agent | | $.website | string | URL of AI Agent | | $.review_cnt | int | number of user reviews | | $.rating | double | rating of reviews 0.0-5.0 | | $.description | string | description of the AI Agent | Json Result Demo ``` { "item_map": { "coding agent": [{ "content_name": "Cursor AI", "publisher_id": "pub-cursor", "detail_url": "https://www.deepnlp.org/store/ai-agent/coding-agent/pub-cursor/cursor-ai", "website": "", "review_cnt": "3", "subfield": "Coding Agent", "field": "AI AGENT", "rating": "3.3", "description": "", "id": "cursor/cursor-ai", "thumbnail_picture": "https://static.aiagenta2z.com/scripts/img/ai_service_content/a7dd95e7eb419437ef4a91f4b0e853cb.jpg" }, { "content_name": "trae ai", "publisher_id": "pub-trae-ai", "detail_url": "https://www.deepnlp.org/store/ai-agent/coding-agent/pub-trae-ai/trae-ai", "website": "", "review_cnt": "2", "subfield": "Coding Agent", "field": "AI AGENT", "rating": "4.0", "description": "", "id": "trae-ai/trae-ai", "thumbnail_picture": "https://static.aiagenta2z.com/scripts/img/ai_service_content/cc43d2dc25488b50b883781e0ae8c988.png" }, { "content_name": "claude code", "publisher_id": "pub-anthropics", "detail_url": "https://www.deepnlp.org/store/ai-agent/coding-agent/pub-anthropics/claude-code", "website": "", "review_cnt": "2", "subfield": "Coding Agent", "field": "AI AGENT", "rating": "3.5", "description": "", "id": "anthropics/claude-code", "thumbnail_picture": "https://static.aiagenta2z.com/scripts/img/ai_service_content/ac31ac4698667fe9dabbb5f0115c1873.png" }, { "content_name": "fine dev", "publisher_id": "pub-fine-dev", "detail_url": "https://www.deepnlp.org/store/ai-agent/ai-agent/pub-fine-dev/fine-dev", "website": "", "review_cnt": "1", "subfield": "AI AGENT", "field": "AI AGENT", "rating": "4.0", "description": "", "id": "fine-dev/fine-dev", "thumbnail_picture": "https://www.fine.dev/_next/static/media/logo.76f79362.svg" }, { "content_name": "claude code", "publisher_id": "pub-claude-code", "detail_url": "https://www.deepnlp.org/store/ai-agent/coding-agent/pub-claude-code/claude-code", "website": "", "review_cnt": "1", "subfield": "Coding Agent", "field": "AI AGENT", "rating": "5.0", "description": "", "id": "claude-code/claude-code", "thumbnail_picture": "https://static.aiagenta2z.com/scripts/img/ai_service_content/7d6c735321396b42b5c2e46499e17a6e.png" }] }, "page_id_map": { "coding agent": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60] }, "query": "coding agent", "KEY_STORE_GROUP_CONTENT_URI_MAP": { "coding agent": "/store/ai-agent?tag\u003dcoding agent" }, "group_cnt": { "coding agent": 5 }, "group_total": { "coding agent": 296 } } ``` ## Supported API Summary | Scenario | Mode | Endpoint | Description | |---------------------| ---- |---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------| | Search by Unique ID | MODE=LIST | GET /api/ai_agent_marketplace/v2?mode=list&id=google-maps/google-maps | - | | | MODE=DICT | GET /api/ai_agent_marketplace/v2?mode=dict&id=google-maps/google-maps | - | | Search by Query | MODE=LIST | GET /api/ai_agent_marketplace/v2?mode=list&page_id=0&count_per_page=20&query=coding%20agent | When you want to search 'Coding Agent' related AI Agents | | | MODE=DICT | GET /api/ai_agent_marketplace/v2?mode=dict&page_id=0&count_per_page=20&query=coding%20agent | Suitable for Search By category name, such as 'Coding Agent' | | No Query, Pagination | MODE=LIST | GET /api/ai_agent_marketplace/v2?mode=list&page_id=0&count_per_page=20 | Explore AI Agents with no query by various category, return a List | | | MODE=DICT | GET /api/ai_agent_marketplace/v2?mode=dict&page_id=0&count_per_page=20 | Explore AI Agents By various Category, return a Map key as category name | ### [Search by Unique ID](#search_unique_id) The unique id of agent meta usually follows the github or nodejs schema, such as unique_id="{owner}/{repo_name}" | Parameter | type | value | |-----------|--------|--------------------------------------------------------| | id | string | unique id of the item, unique_id="{owner}/{repo_name}" | | return_fields | string | optinal, e.g. return_fields=tools,config | **List Mode** http ```http GET /api/ai_agent_marketplace/v2?mode=list&id=google-maps/google-maps ``` Curl ```http curl 'https://www.deepnlp.org/api/ai_agent_marketplace/v2?mode=list&id=google-maps/google-maps' ``` **Dict Mode** http ```http GET /api/ai_agent_marketplace/v2?mode=dict&id=google-maps/google-maps ``` Curl ```http curl 'https://www.deepnlp.org/api/ai_agent_marketplace/v2?mode=dict&id=google-maps/google-maps' ``` ### [Search by Query](#search_query) | Parameter | type | value | |----------------|--------|-----------------------------------------------------------------| | query | string | string of query | | page_id | int | current id of page | | count_per_page | int | default count of items per page. | | offset | int | number of items to skip, equivalent to page_id * count_per_page | | return_fields | string | optinal, e.g. return_fields=tools,config | **List Mode** http ```http GET /api/ai_agent_marketplace/v2?mode=list&query=coding agent&page_id=0&count_per_page=5 ``` Curl ```http curl 'https://www.deepnlp.org/api/ai_agent_marketplace/v2?mode=list&query=coding agent&page_id=0&count_per_page=5' ``` **Dict Mode** http ```http GET /api/ai_agent_marketplace/v2?mode=dict&query=coding agent&page_id=0&count_per_page=5 ``` Curl ```http curl 'https://www.deepnlp.org/api/ai_agent_marketplace/v2?mode=dict&query=coding agent&page_id=0&count_per_page=5' ``` ### [Pagination Exploration with No Query](#pagination_no_query) | Parameter | type | value | |----------------|--------|-----------------------------------------| | page_id | int | current id of page | | count_per_page | int | default count of items per page. | | offset | int | number of items to skip, equivalent to page_id * count_per_page | **List Mode** http ```http GET /api/ai_agent_marketplace/v2?mode=list&page_id=0&count_per_page=5 ``` Curl ```http curl 'https://www.deepnlp.org/api/ai_agent_marketplace/v2?mode=list&page_id=0&count_per_page=5' ``` **Dict Mode** http ```http GET /api/ai_agent_marketplace/v2?mode=dict&page_id=0&count_per_page=5 ``` Curl ```http curl 'https://www.deepnlp.org/api/ai_agent_marketplace/v2?mode=dict&page_id=0&count_per_page=5' ``` ## [API V1](#api_v1) ```http GET /api/ai_agent_marketplace/v1?q=coding agent&limit=20 ``` **Curl** ```http curl 'http://www.deepnlp.org/api/ai_agent_marketplace/v1?q=coding agent&limit=20' ' ``` **Parameters** | Parameter | type | value | |---------------|--------|----------------------------------------| | q | string | /api/ai_agent_marketplace/v1?query=map | | return_fields | string | /api/ai_agent_marketplace/v1?q=coding agent&limit=20&return_fields=statistic | category | string | /api/ai_agent_marketplace/v1?category=coding agent | | list | string | /api/ai_agent_marketplace/v1? | | limit | int | 5 | | mode | string | mode='list' or 'dict' | **Results** ``` { "items":[{"content_name":"AI Agent 28","publisher_id":"pub-user-agent-v1","review_cnt":0,"statistic":{},"subfield":"Coding Agent","field":"AI Agent","rating":"0.0","description":"My AI Agent can solve math problem","content_tag_list":"AI AGENT"},{"content_name":"AI Agent 27","publisher_id":"pub-user-agent-v1","review_cnt":0,"statistic":{},"subfield":"Coding Agent","field":"AI Agent","rating":"0.0","description":"My AI Agent can solve math problem","content_tag_list":"AI AGENT"},{"content_name":"AI Agent 25","publisher_id":"pub-user-agent-v1","review_cnt":0,"statistic":{},"subfield":"Coding Agent","field":"AI Agent","rating":"0.0","description":"My AI Agent can solve math problem","content_tag_list":"AI AGENT"}], "sub_category":"", "limit":1000, "category":"ai agent" } ```