# Directories

URL: https://submitator.com/docs/api/directories

> The catalog a launch picks from, highest Domain Rating first.

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.

## List directories

`GET https://api.submitator.com/v1/directories`

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.

| Parameter | In | Required | What it is |
| --- | --- | --- | --- |
| `topic` | query | No | Only directories with this topic. |
| `min_dr` | query | No | Only directories with a Domain Rating of at least this value, 0 to 100. |
| `requires` | query | No | Only directories with this requirement in `requires`. `none` returns the directories that require nothing. |
| `audience` | query | No | Only directories limited to this kind of product in `audience`. `any` returns the directories that take every product. |
| `q` | query | No | Only directories whose name or domain contains this text, ignoring case. 2 to 100 characters. |
| `cursor` | query | No | `next_cursor` from the previous page of the same list, as you received it. Leave it out for the first page. |
| `limit` | query | No | How many items to return, 1 to 100. Defaults to 20. |

Response 200:

```json
{
  "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"
}
```

Typical errors: [`validation_failed`](https://submitator.com/docs/errors#validation_failed), [`invalid_cursor`](https://submitator.com/docs/errors#invalid_cursor), [`rate_limited`](https://submitator.com/docs/errors#rate_limited).

## Read a directory

`GET https://api.submitator.com/v1/directories/{directory_id}`

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.

| Parameter | In | Required | What it is |
| --- | --- | --- | --- |
| `directory_id` | path | Yes | The directory's id. |

Response 200:

```json
{
  "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"
}
```

Typical errors: [`not_found`](https://submitator.com/docs/errors#not_found), [`rate_limited`](https://submitator.com/docs/errors#rate_limited).