Directories
The catalog a launch picks from, highest Domain Rating first. Domain Rating (DR) is a 0 to 100 score of a site's backlink profile, measured by Ahrefs.
Before your first purchase, test keys see the top 20 directories only.
Returns the directories a launch can pick from, highest Domain Rating first. Filter by topic, minimum Domain Rating, requirement or audience, or search names with q. Before your first purchase, test keys see the top 20 only.
topic?stringOnly directories with this topic.
"startups""ai_tools""saas""dev_tools""b2b""software""other"min_dr?integerOnly directories with a Domain Rating of at least this value, 0 to 100.
0 <= value <= 100requires?stringOnly directories with this requirement in requires. none returns the directories that require nothing.
"badge""competitors""promo_code""none"audience?stringOnly directories limited to this kind of product in audience. any returns the directories that take every product.
"b2b""ai""directory""any"q?stringOnly directories whose name or domain contains this text, ignoring case. 2 to 100 characters.
2 <= length <= 100cursor?stringnext_cursor from the previous page of the same list, as you received it. Leave it out for the first page.
length <= 500limit?integerHow many items to return, 1 to 100. Defaults to 20.
1 <= value <= 10020One page of directories.
application/json- response
One page of a list. Directories, highest Domain Rating first.
object*stringAlways list.
data*array<>The items on this page.
has_more*booleantrue when there is another page.
next_cursor*|Send it as cursor for the next page. null when has_more is false.
length <= 500Typical errors
curl "https://api.submitator.com/v1/directories" \ -H "Authorization: Bearer $SUBMITATOR_API_KEY"{ "object": "list", "data": [ { "object": "directory", "id": "dir_2Lm8Wq3Zk7Rt1Xc5Vb9NdF", "livemode": false, "name": "BetaList", "url": "https://betalist.com", "domain_rating": 73, "topic": "startups", "backlink": "dofollow", "requires": [], "audience": [], "logo_url": "https://feed.example.net/a/x1Lq7Rt.k9Zm" }, { "object": "directory", "id": "dir_6Pw3Kx9Ty2Rq7Lm1Zb5VcN", "livemode": false, "name": "SaaSHub", "url": "https://www.saashub.com", "domain_rating": 61, "topic": "software", "backlink": "nofollow", "requires": [], "audience": [], "logo_url": "https://feed.example.net/a/h4Sw8Lp.q2Xn" }, { "object": "directory", "id": "dir_3Vb8Qm2Xk6Lt9Wr4Nc1ZpG", "livemode": false, "name": "Uneed", "url": "https://www.uneed.best", "domain_rating": 58, "topic": "startups", "backlink": "dofollow", "requires": [ "badge" ], "audience": [], "logo_url": "https://feed.example.net/a/u7Nd3Kc.w5Rb" } ], "has_more": true, "next_cursor": "cur_Dz4Kq8Wx2Lt6Vb9M"}Returns one directory from the catalog. An id that is not in the catalog, or not in the preview before your first purchase, returns 404.
directory_id*stringThe directory's id.
^dir_[0-9A-Za-z]{22}$The directory.
application/json- response
A directory in the catalog.
object*stringAlways directory.
id*stringThe directory's id. Use it in include, exclude and excluded_directories.
^dir_[0-9A-Za-z]{22}$livemode*booleantrue in live mode, false in test mode. The catalog is the same in both.
name*stringThe directory's name.
url*stringThe directory's home page.
uridomain_rating*|The directory's Domain Rating from Ahrefs, 0 to 100. null until it is measured.
0 <= value <= 100topic*|What the directory is about. null when it has no single topic.
"startups""ai_tools""saas""dev_tools""b2b""software""other"nullbacklink*|Whether a live listing's link to the product is dofollow or nofollow. null when unknown.
"dofollow""nofollow"nullrequires*array<>What a project needs before this directory takes it: badge (the badge verified on the site), competitors (at least 1 in competitors), promo_code (a promo_code). Empty when it needs nothing.
audience*array<>The only kinds of products this directory takes, matched against the project's audience. Empty when it takes every product.
logo_url*|The directory's logo, served from the badge feed host. null when there is none.
uriTypical errors
curl "https://api.submitator.com/v1/directories/dir_3Vb8Qm2Xk6Lt9Wr4Nc1ZpG" \ -H "Authorization: Bearer $SUBMITATOR_API_KEY"{ "object": "directory", "id": "dir_3Vb8Qm2Xk6Lt9Wr4Nc1ZpG", "livemode": false, "name": "Uneed", "url": "https://www.uneed.best", "domain_rating": 58, "topic": "startups", "backlink": "dofollow", "requires": [ "badge" ], "audience": [], "logo_url": "https://feed.example.net/a/u7Nd3Kc.w5Rb"}