Public API

Programmatic access to the Agent Directory and catalog.

Discover valid tools, submit products, attach structured Agent Directory claims, check review state, and browse the approved catalog through a versioned JSON API. No API keys. No accounts. Manual review stays in the loop.

Recommended workflow

Step 1

Discover valid tools

Fetch the current tool inventory before submitting so you can use valid tool slugs instead of guessing category names.

Step 2

Submit the product

Send a JSON payload to the submit endpoint. API submissions always enter the manual review queue as free-tier pending listings.

Step 3

Poll review status

Use the product slug and submitter email to check whether a pending listing has been approved yet.

Step 4

Browse and verify the catalog

Use products and search endpoints to inspect approved listings, tool coverage, and agent-native inventory already in the directory.

Start here

Read docs OpenAPI spec Fetch tools Agent manifest

Request and response shapes

The landing page should be enough to evaluate the contract before you open the docs. The full field-by-field reference still lives under /docs.

GET/api/v1/tools

Discover valid tool slugs

Pull the current tool inventory before you submit or build filtered catalog views.

Key fields

no required input

Example request

curl https://www.madewithstack.com/api/v1/tools

Success

{
  "tools": [
    {
      "slug": "claude",
      "name": "Claude",
      "category": "models-providers",
      "description": "Model provider for conversational and agent workflows."
    },
    {
      "slug": "supabase",
      "name": "Supabase",
      "category": "backend-db",
      "description": "Postgres backend, auth, and storage platform."
    }
  ]
}

POST/api/v1/submit

Submit a product

Programmatic intake for new listings and optional Agent Directory claims.

Key fields

nameurldescriptionemail

Example request

curl -X POST https://www.madewithstack.com/api/v1/submit \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AgentFlow",
    "url": "https://agentflow.dev",
    "description": "Workflow automation for multi-agent pipelines.",
    "email": "founder@agentflow.dev",
    "tool_slugs": ["langchain", "claude"],
    "qualification_type": "agent_built",
    "agent_use_case": "operations",
    "qualification_statement": "Agents handled substantial parts of the workflow and build process.",
    "workflow_summary": "The product routes operational work through an agentic workflow.",
    "agent_tools_used": ["Cursor", "Claude"],
    "supporting_links": ["https://agentflow.dev/docs"],
    "founder_name": "Ada Smith",
    "audience_tags": ["b2b", "for-developers"]
  }'

Submission created

{
  "success": true,
  "slug": "agentflow",
  "receiptSent": true,
  "review_status_url": "https://www.madewithstack.com/api/v1/products/agentflow?email=founder%40agentflow.dev",
  "owner_claim": {
    "email": "founder@agentflow.dev",
    "status": "unverified",
    "verification_email_sent": true
  },
  "claim_status": "submitted",
  "claim_eligibility": "agent_directory",
  "next_action_code": "UNDER_EDITORIAL_REVIEW"
}

GET/api/v1/products

Browse approved catalog data

Filtered product inventory for discovery, integrations, and mirrored directories.

Key fields

Example request

curl "https://www.madewithstack.com/api/v1/products?limit=10&sort=newest&is_agent=true"

Success

{
  "products": [
    {
      "id": "prod_123",
      "name": "AgentFlow",
      "slug": "agentflow",
      "description": "Workflow automation for multi-agent pipelines.",
      "url": "https://agentflow.dev",
      "favicon_url": "https://agentflow.dev/icon.png",
      "founder_name": "Ada Smith",
      "founder_twitter": "ada_smith",
      "founder_profile_slug": "ada-smith",
      "launch_date": null,
      "status": "approved",
      "created_at": "2026-03-10T08:00:00.000Z",
      "approved_at": "2026-03-11T09:15:00.000Z",
      "view_count": 42,
      "is_featured": false,
      "featured_rank": 100,
      "screenshot_url": "https://agentflow.dev/shot.png",
      "submission_tier": "free",
      "review_priority": 100,
      "audience_tags": [
        "b2b",
        "for-developers"
      ],
      "badge_verified": false,
      "is_agent_product": true,
      "qualification_type": "agent_native",
      "agent_use_case": "operations",
      "qualification_statement": "Agent-led workflow is central to the product.",
      "workflow_summary": "The product uses an agentic workflow as the main user experience.",
      "agent_tools_used": [
        "Claude",
        "LangChain"
      ],
      "supporting_links": [
        "https://agentflow.dev/docs"
      ],
      "claim_review_status": "verified",
      "claim_reviewed_at": "2026-03-11T09:20:00.000Z",
      "claim_review_notes": null,
      "claim_verified_by": "editor@madewithstack.com",
      "claim_evidence_summary": "Reviewed against public docs and product workflow pages.",
      "tools": [
        {
          "id": "tool_1",
          "name": "Claude",
          "slug": "claude",
          "description": "Model provider",
          "icon_url": null,
          "category": "models-providers",
          "product_count": 12,
          "created_at": "2026-03-01T00:00:00.000Z"
        }
      ]
    }
  ],
  "total": 1,
  "offset": 0,
  "limit": 24,
  "hasMore": false
}

GET/api/v1/products/:slug

Check review status

Pending review polling for the original submitter or public approved listing detail by slug.

Key fields

Example request

curl "https://www.madewithstack.com/api/v1/products/agentflow?email=founder@agentflow.dev"

Pending submission

{
  "product": {
    "slug": "agentflow",
    "name": "AgentFlow",
    "status": "pending",
    "created_at": "2026-03-11T09:15:00.000Z"
  },
  "badge": {
    "available": "boolean",
    "image_url": "string",
    "verification": {
      "status": "\"pending_approval\" | \"awaiting_verification\" | \"verified\" | \"paid_dofollow\"",
      "is_dofollow": "boolean",
      "requires_badge_install": "boolean",
      "requires_manual_review": "boolean",
      "detail": "string"
    }
  },
  "claim_status": "submitted",
  "claim_eligibility": "agent_directory",
  "next_action_code": "UNDER_EDITORIAL_REVIEW"
}

Endpoint summary

The detailed request and response contracts live under /docs.

Open docs

GET/api/v1/tools

List every currently known tool slug, name, category, and description.

No request parameters.

GET/api/v1/products

Browse approved listings with pagination, sorting, and composable filters.

Query: offset, limit, sort, category, audience

GET/api/v1/products/:slug

Fetch an approved listing by slug or check the status of a pending submission with email verification.

Query: email

GET/api/v1/search

Search tools and approved products by keyword and receive absolute URLs.

Query: q

POST/api/v1/submit

Submit a product programmatically into the manual review queue.

Body: name, url, description, email, tool_slugs

GET/api/v1/openapi

Return the OpenAPI 3.1 specification for the public API.

No request parameters.

GET/api/v1/schema

Return the machine-readable specification for the public API.

No request parameters.

Shared error model

VALIDATION_ERROR

Missing, malformed, or unsupported request data.

DUPLICATE_DOMAIN

A product with the same normalized domain already exists.

INVALID_TOOL_SLUGS

One or more submitted tool slugs are not present in the directory.

PUBLIC_API_TEMPORARILY_RESTRICTED

Anonymous public API access is temporarily restricted while abuse controls are active.

RATE_LIMITED

The request exceeded the public API rate limit window.

INTERNAL_ERROR

Unexpected server error. Retry later.

Rate limits

Per IP: 1 submission per hour. Applies to POST /api/v1/submit only.
Per email: 3 submissions per 24 hours. Applies to POST /api/v1/submit only.
Retry-After: Returned on 429 responses. The value is the wait time in seconds before retrying.

Need the full contract?

Use the docs hub for request fields, response shapes, workflow guides, and the root machine-readable manifests.

Open docs View llms-full.txt

{ "tools": [ { "slug": "claude", "name": "Claude", "category": "models-providers", "description": "Model provider for conversational and agent workflows." }, { "slug": "supabase", "name": "Supabase", "category": "backend-db", "description": "Postgres backend, auth, and storage platform." } ] }

curl -X POST https://www.madewithstack.com/api/v1/submit \ -H "Content-Type: application/json" \ -d '{ "name": "AgentFlow", "url": "https://agentflow.dev", "description": "Workflow automation for multi-agent pipelines.", "email": "founder@agentflow.dev", "tool_slugs": ["langchain", "claude"], "qualification_type": "agent_built", "agent_use_case": "operations", "qualification_statement": "Agents handled substantial parts of the workflow and build process.", "workflow_summary": "The product routes operational work through an agentic workflow.", "agent_tools_used": ["Cursor", "Claude"], "supporting_links": ["https://agentflow.dev/docs"], "founder_name": "Ada Smith", "audience_tags": ["b2b", "for-developers"] }'

{ "success": true, "slug": "agentflow", "receiptSent": true, "review_status_url": "https://www.madewithstack.com/api/v1/products/agentflow?email=founder%40agentflow.dev", "owner_claim": { "email": "founder@agentflow.dev", "status": "unverified", "verification_email_sent": true }, "claim_status": "submitted", "claim_eligibility": "agent_directory", "next_action_code": "UNDER_EDITORIAL_REVIEW" }

{ "products": [ { "id": "prod_123", "name": "AgentFlow", "slug": "agentflow", "description": "Workflow automation for multi-agent pipelines.", "url": "https://agentflow.dev", "favicon_url": "https://agentflow.dev/icon.png", "founder_name": "Ada Smith", "founder_twitter": "ada_smith", "founder_profile_slug": "ada-smith", "launch_date": null, "status": "approved", "created_at": "2026-03-10T08:00:00.000Z", "approved_at": "2026-03-11T09:15:00.000Z", "view_count": 42, "is_featured": false, "featured_rank": 100, "screenshot_url": "https://agentflow.dev/shot.png", "submission_tier": "free", "review_priority": 100, "audience_tags": [ "b2b", "for-developers" ], "badge_verified": false, "is_agent_product": true, "qualification_type": "agent_native", "agent_use_case": "operations", "qualification_statement": "Agent-led workflow is central to the product.", "workflow_summary": "The product uses an agentic workflow as the main user experience.", "agent_tools_used": [ "Claude", "LangChain" ], "supporting_links": [ "https://agentflow.dev/docs" ], "claim_review_status": "verified", "claim_reviewed_at": "2026-03-11T09:20:00.000Z", "claim_review_notes": null, "claim_verified_by": "editor@madewithstack.com", "claim_evidence_summary": "Reviewed against public docs and product workflow pages.", "tools": [ { "id": "tool_1", "name": "Claude", "slug": "claude", "description": "Model provider", "icon_url": null, "category": "models-providers", "product_count": 12, "created_at": "2026-03-01T00:00:00.000Z" } ] } ], "total": 1, "offset": 0, "limit": 24, "hasMore": false }

{ "product": { "slug": "agentflow", "name": "AgentFlow", "status": "pending", "created_at": "2026-03-11T09:15:00.000Z" }, "badge": { "available": "boolean", "image_url": "string", "verification": { "status": "\"pending_approval\" | \"awaiting_verification\" | \"verified\" | \"paid_dofollow\"", "is_dofollow": "boolean", "requires_badge_install": "boolean", "requires_manual_review": "boolean", "detail": "string" } }, "claim_status": "submitted", "claim_eligibility": "agent_directory", "next_action_code": "UNDER_EDITORIAL_REVIEW" }

Shared error model