{
  "schema": "submitmystartup-api/v1",
  "name": "Where to Submit Your Startup API",
  "description": "A free, read-only list of places to submit a startup (directories, launch sites, communities, editorial sites), with structured facts on cost, eligibility, requirements, and wait. Facts that are not on record are null, never guessed.",
  "generatedAt": "2026-10-04T06:56:00.600Z",
  "updatedOn": "2026-10-04",
  "counts": {
    "directories": 185,
    "tried": 154,
    "withFacts": 185,
    "withMyAttempt": 107,
    "byCategory": {
      "paid": 20,
      "directories": 70,
      "specialist": 47,
      "problems": 32,
      "reddit": 16
    },
    "byFree": {
      "No": 20,
      "Yes*": 63,
      "Unknown": 79,
      "Yes": 23
    },
    "byState": {
      "live": 153,
      "dead": 23,
      "broken": 4,
      "inactive": 2,
      "closed": 3
    }
  },
  "endpoints": {
    "docs": "https://submitmystartup.com/api/",
    "meta": "https://submitmystartup.com/api/v1/meta.json",
    "directories": "https://submitmystartup.com/api/v1/directories.json",
    "directory": "https://submitmystartup.com/api/v1/directories/{id}.json",
    "mcp": "https://submitmystartup.com/mcp",
    "mcpCard": "https://submitmystartup.com/.well-known/mcp.json",
    "llms": "https://submitmystartup.com/llms.txt"
  },
  "source": {
    "list": "https://github.com/mmmmingos/where-to-submit-your-startup",
    "readme": "https://github.com/mmmmingos/where-to-submit-your-startup/blob/main/README.md",
    "note": "The public README is the source of truth for listings. This API restructures its rows and the facts from my own submission attempts."
  },
  "license": {
    "name": "MIT",
    "url": "https://github.com/mmmmingos/where-to-submit-your-startup/blob/main/LICENSE",
    "copyright": "Copyright (c) 2026 mmmmingos",
    "terms": "Use, copy, modify, merge, publish, distribute, sublicense, and sell copies, provided the copyright notice and the permission notice are included in all copies or substantial portions.",
    "credit": "Please credit \"Where to Submit Your Startup\" and link to https://github.com/mmmmingos/where-to-submit-your-startup."
  },
  "fields": {
    "id": "Stable id from the list: the name lowercased, with other characters turned into hyphens.",
    "category": "Section of the list: directories, paid, specialist (only for some startups), reddit, or problems (reported problems).",
    "free": "The list's Free? label: Yes, Yes* (free with a material catch), No (paid only), or Unknown.",
    "notes": "The list's notes for the row.",
    "lastChecked": "The row's Last checked date on the list.",
    "tried": "true when I have tried the place by submitting my own site to it, or null if its facts are not recorded yet.",
    "myAttempt": "The status of my own attempt as the website shows it (submitted, published, rejected, or blocked), its date, or null.",
    "links": "self: this entry's JSON. list: the section of the public list that holds its row. site: its row on the website.",
    "facts": "Structured facts, or null if they are not recorded yet. A fact that is not on record is null, never guessed.",
    "facts.format": "How a listing happens: directory, launch (a dated launch), profile (a company profile), editorial (a pitch for coverage), community (a post), app-review, review-site (G2 and similar), gallery (a design gallery), or beta-testing.",
    "facts.state": "live, or for reported problems: broken (the submission path doesn't work), inactive (abandoned), closed (doesn't take listings), or dead (gone).",
    "facts.stateNote": "What was seen, with the date, for problems and for live sites with a quirk worth knowing.",
    "facts.accepts.products": "\"any\" (no product-type restriction on record), or a list of product tags: it takes products with at least one of them.",
    "facts.accepts.audience": "any, b2b (business products only), or b2c (business-to-business products aren't covered).",
    "facts.accepts.stage": "any, pre-release (unreleased or beta only), released (no alpha or beta software), or early-stage (young startups only; the rule is in accepts.rule).",
    "facts.accepts.region": "{\"scope\": \"global\"}, or a limited region: {scope: \"limited\", basis, label, areas}. basis headquarters: the startup must be based there. basis market: the site covers that market or language. areas are ISO 3166 codes (AU, US-WA).",
    "facts.accepts.excludes": "Product tags it turns down.",
    "facts.accepts.rule": "The eligibility or posting rule in words.",
    "facts.cost.free": "free, free-with-catch, or paid-only.",
    "facts.cost.paidOption": "Whether a paid option for the listing (paid listing, queue skip, upgrade, or promotion) was seen.",
    "facts.cost.cheapestPaid": "{amount, currency, period, name}: the lowest regular price seen for such an option. period is one-time, day, week, month, year, or null.",
    "facts.requirements.<key>": "What the free path needs: required, alternative (one of the alternatives is needed), optional (helps but isn't needed), or no. Keys: account, badge (a badge or backlink on your site), domainEmail (an email on your own domain; Gmail is refused), engagement (upvotes, comments, or ratings on other products first), socialProfile, phone, captcha, ownDomain, invitation, revenueProof.",
    "facts.requirements.domainRatingAbove": "Your site's domain rating must be above this.",
    "facts.requirements.other": "Other requirements and quirks of the free path.",
    "facts.wait": "The free path's wait until the listing is live: {minDays, maxDays, basis, text}. basis stated: the site's own figure. basis observed: a date or queue position I was given.",
    "facts.review": "none (live without a review), moderated (reviewed, usually accepted), or curated (editors choose, so a listing isn't guaranteed).",
    "facts.backlink": "dofollow, nofollow, or conditional (dofollow only in some cases), as the site describes its free listing's link.",
    "facts.lastChecked": "The newest date behind the facts. Never older than lastChecked.",
    "facts.sources": "Where each fact came from: public-list (the row, on its Last checked date) or submission-report (my attempt on that date), with the facts it supports."
  },
  "filters": {
    "category": [
      {
        "id": "directories",
        "name": "Directories & profiles"
      },
      {
        "id": "reddit",
        "name": "Reddit communities"
      },
      {
        "id": "paid",
        "name": "Paid services"
      },
      {
        "id": "specialist",
        "name": "Only for some startups"
      },
      {
        "id": "problems",
        "name": "Reported problems"
      }
    ],
    "free": [
      "Yes",
      "Yes*",
      "No",
      "Unknown"
    ],
    "format": [
      "directory",
      "launch",
      "profile",
      "editorial",
      "community",
      "app-review",
      "review-site",
      "gallery",
      "beta-testing"
    ],
    "state": [
      "live",
      "broken",
      "inactive",
      "closed",
      "dead"
    ],
    "productTags": [
      "software",
      "web-apps",
      "websites",
      "saas",
      "mobile-apps",
      "mac-apps",
      "desktop-apps",
      "browser-extensions",
      "services",
      "ai-tools",
      "ai-developer-tools",
      "developer-tools",
      "no-code-tools",
      "marketing-tools",
      "open-source",
      "kids-apps",
      "ecommerce",
      "agencies",
      "media-buyers",
      "products-with-confetti",
      "computing-topics",
      "designs",
      "free-online-tools",
      "single-purpose-utilities",
      "converters",
      "ai-tool-aggregators",
      "mobile-only-apps",
      "waitlist-only",
      "adult",
      "gambling",
      "crypto",
      "mlm"
    ],
    "impliedTags": {
      "web-apps": [
        "software",
        "websites"
      ],
      "saas": [
        "software",
        "web-apps",
        "websites"
      ],
      "mobile-apps": [
        "software"
      ],
      "mac-apps": [
        "software"
      ],
      "desktop-apps": [
        "software"
      ],
      "browser-extensions": [
        "software"
      ],
      "ai-developer-tools": [
        "ai-tools",
        "developer-tools",
        "software"
      ],
      "developer-tools": [
        "software"
      ],
      "no-code-tools": [
        "software"
      ],
      "marketing-tools": [
        "software"
      ]
    },
    "audience": [
      "any",
      "b2b",
      "b2c"
    ],
    "stage": [
      "any",
      "pre-release",
      "released",
      "early-stage"
    ],
    "regionBasis": [
      "headquarters",
      "market"
    ],
    "regionsOnRecord": [
      {
        "scope": "limited",
        "basis": "market",
        "label": "Africa (a database of African startups; the form accepts any headquarters country)",
        "areas": [
          "DZ",
          "AO",
          "BJ",
          "BW",
          "BF",
          "BI",
          "CV",
          "CM",
          "CF",
          "TD",
          "KM",
          "CG",
          "CD",
          "CI",
          "DJ",
          "EG",
          "GQ",
          "ER",
          "SZ",
          "ET",
          "GA",
          "GM",
          "GH",
          "GN",
          "GW",
          "KE",
          "LS",
          "LR",
          "LY",
          "MG",
          "MW",
          "ML",
          "MR",
          "MU",
          "MA",
          "MZ",
          "NA",
          "NE",
          "NG",
          "RW",
          "ST",
          "SN",
          "SC",
          "SL",
          "SO",
          "ZA",
          "SS",
          "SD",
          "TZ",
          "TG",
          "TN",
          "UG",
          "ZM",
          "ZW"
        ]
      },
      {
        "scope": "limited",
        "basis": "market",
        "label": "Brazil (a Portuguese-language portal)",
        "areas": [
          "BR"
        ]
      },
      {
        "scope": "limited",
        "basis": "headquarters",
        "label": "Chicago",
        "areas": [
          "US-IL"
        ]
      },
      {
        "scope": "limited",
        "basis": "headquarters",
        "label": "India (headquarters or most of the workforce)",
        "areas": [
          "IN"
        ]
      },
      {
        "scope": "limited",
        "basis": "headquarters",
        "label": "Nordic and Baltic countries",
        "areas": [
          "DK",
          "FI",
          "IS",
          "NO",
          "SE",
          "EE",
          "LV",
          "LT"
        ]
      },
      {
        "scope": "limited",
        "basis": "headquarters",
        "label": "Pacific Northwest (Washington, Oregon, Idaho, British Columbia)",
        "areas": [
          "US-WA",
          "US-OR",
          "US-ID",
          "CA-BC"
        ]
      },
      {
        "scope": "limited",
        "basis": "market",
        "label": "Products with customers in the United States",
        "areas": [
          "US"
        ]
      }
    ],
    "costFree": [
      "free",
      "free-with-catch",
      "paid-only"
    ],
    "priceCurrencies": [
      "EUR",
      "USD"
    ],
    "pricePeriod": [
      "one-time",
      "day",
      "week",
      "month",
      "year"
    ],
    "requirementKeys": [
      "account",
      "badge",
      "domainEmail",
      "engagement",
      "socialProfile",
      "phone",
      "captcha",
      "ownDomain",
      "invitation",
      "revenueProof"
    ],
    "requirementValues": [
      "required",
      "alternative",
      "optional",
      "no"
    ],
    "waitBasis": [
      "stated",
      "observed"
    ],
    "review": [
      "none",
      "moderated",
      "curated"
    ],
    "backlink": [
      "dofollow",
      "nofollow",
      "conditional"
    ],
    "myAttemptStatus": [
      "submitted",
      "published",
      "rejected",
      "blocked"
    ],
    "sourceType": [
      "public-list",
      "submission-report"
    ]
  }
}
