# EpicDirectories Public API

**Canonical:** https://apis.io/apis/epicdirectories/epicdirectories-public-api/  
**Provider:** EpicDirectories — https://apis.io/providers/epicdirectories/  
**Base URL:** https://api.epicdirectories.com  
**Documentation:** https://epicdirectories.com/developers/

EpicDirectories Public API is one of 31 APIs that [EpicDirectories](https://apis.io/providers/epicdirectories/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Public. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The public API from EpicDirectories — 46 operation(s) for public.

## Operations (60 of 74)

| Method | Path | Summary |
|---|---|---|
| GET | `/public/v1/directories/{directory}` | Get directory configuration and schema |
| PATCH | `/public/v1/directories/{directory}` | Update directory configuration |
| GET | `/public/v1/me` | Describe this API key |
| POST | `/public/v1/directories/{directory}/taxonomies` | Create a taxonomy |
| GET | `/public/v1/directories/{directory}/taxonomies` | List this directory's taxonomies |
| POST | `/public/v1/directories/{directory}/taxonomies/{taxonomy}/terms` | Create a taxonomy term |
| GET | `/public/v1/directories/{directory}/taxonomies/{taxonomy}/terms` | List a taxonomy's terms, with a listing count each |
| GET | `/public/v1/directories/{directory}/turnstile` | Which Turnstile widget verifies this directory's public forms |
| POST | `/public/v1/directories/{directory}/turnstile/provision` | Create or reconcile this directory's own Turnstile widget |
| POST | `/public/v1/directories/{directory}/attribute-templates` | Create an attribute template |
| GET | `/public/v1/directories/{directory}/attribute-templates` | List attribute templates |
| GET | `/public/v1/directories/{directory}/attribute-templates/{template}` | Get one attribute template |
| PATCH | `/public/v1/directories/{directory}/attribute-templates/{template}` | Update an attribute template |
| DELETE | `/public/v1/directories/{directory}/attribute-templates/{template}` | Delete an attribute template |
| DELETE | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}` | Archive a listing (soft delete) |
| GET | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}` | Get a listing unambiguously by type + slug |
| PATCH | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}` | Update a listing by type + slug (including renaming its slug) |
| GET | `/public/v1/directories/{directory}/export` | Full-directory export for static-site builds |
| GET | `/public/v1/directories/{directory}/listings` | List published listings |
| POST | `/public/v1/directories/{directory}/listings` | Create a listing in this directory |
| GET | `/public/v1/directories/{directory}/listings/bulk` | Bulk fetch all published listings for SSG / static builds |
| POST | `/public/v1/directories/{directory}/listings/bulk` | Bulk upsert listings by (listingType, slug) |
| GET | `/public/v1/directories/{directory}/listings/{listing}` | Get a single listing by slug or ID |
| GET | `/public/v1/directories/{directory}/recipes` | List recipe definitions |
| POST | `/public/v1/directories/{directory}/recipes` | Create a recipe definition |
| GET | `/public/v1/directories/{directory}/recipes/{recipe}/definition` | Read one recipe definition |
| PATCH | `/public/v1/directories/{directory}/recipes/{recipe}` | Update a recipe definition |
| DELETE | `/public/v1/directories/{directory}/recipes/{recipe}` | Delete a recipe definition |
| GET | `/public/v1/directories/{directory}/recipes/{recipe}` | Execute a recipe and get matching listings |
| GET | `/public/v1/directories/{directory}/jobs` | List this directory's jobs |
| POST | `/public/v1/directories/{directory}/jobs` | Enqueue a job |
| GET | `/public/v1/directories/{directory}/jobs/{jobId}` | Get one job |
| POST | `/public/v1/directories/{directory}/jobs/{jobId}/cancel` | Cancel a job |
| POST | `/public/v1/directories/{directory}/jobs/{jobId}/retry` | Retry a failed or cancelled job |
| GET | `/public/v1/directories/{directory}/taxonomies/{taxonomy}/terms/{term}` | Read one term by slug |
| PATCH | `/public/v1/directories/{directory}/taxonomies/{taxonomy}/terms/{term}` | Update a term's label / parent / metadata |
| DELETE | `/public/v1/directories/{directory}/taxonomies/{taxonomy}/terms/{term}` | Delete a taxonomy term |
| GET | `/public/v1/directories/{directory}/taxonomies/{taxonomy}/resolve` | Resolve a single raw value to a taxonomy term |
| POST | `/public/v1/directories/{directory}/taxonomies/{taxonomy}/resolve-batch` | Resolve a batch of raw values; report which mapped and which did not |
| GET | `/public/v1/directories/{directory}/taxonomies/{taxonomy}` | Get one taxonomy |
| PATCH | `/public/v1/directories/{directory}/taxonomies/{taxonomy}` | Rename a taxonomy |
| DELETE | `/public/v1/directories/{directory}/taxonomies/{taxonomy}` | Delete a taxonomy |
| POST | `/public/v1/directories/{directory}/listings/batch` | Batch FETCH listings by (listingType, slug) pairs (read-only) |
| GET | `/public/v1/directories/{directory}/listing-aliases` | The directory's redirect map — every slug a listing has moved off |
| DELETE | `/public/v1/directories/{directory}/listing-aliases/{listingType}/{listingSlug}` | Release a retired slug so it can be used again |
| PUT | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/attributes` | Replace all attribute values on a listing |
| PUT | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/terms` | Replace all taxonomy term assignments on a listing |
| PATCH | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/terms` | Add and remove a listing's taxonomy terms without sending the whole set |
| GET | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/snapshots` | Read a listing's source snapshots |
| POST | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/snapshots` | Write a raw research/source payload to the listing's evidence locker |
| GET | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/snapshots/latest/{source}` | Read the newest snapshot from one source |
| GET | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/snapshots/{snapshotId}` | Read one snapshot |
| DELETE | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/snapshots/{snapshotId}` | Delete one snapshot |
| POST | `/public/v1/directories/{directory}/listings/{listingType}/{listingSlug}/enrich` | Enrich one listing from Google (geocode or Places) |
| POST | `/public/v1/directories/{directory}/site-probes/sweep` | Queue site probes for this directory’s listings |
| GET | `/public/v1/directories/{directory}/site-probes/dead-links` | Listings whose site is not answering |
| POST | `/public/v1/directories/{directory}/screenshots` | Queue homepage screenshots for this directory’s listings |
| GET | `/public/v1/directories/{directory}/screenshots` | Screenshot coverage for this directory |
| POST | `/public/v1/directories/{directory}/research` | Gather facts from this directory’s listings’ own websites |
| GET | `/public/v1/directories/{directory}/research` | Research coverage for this directory |

…and 14 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/epicdirectories/refs/heads/main/openapi/epicdirectories-public-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/epicdirectories/refs/heads/main/json-schema/epicdirectories-create-webhook-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/epicdirectories/refs/heads/main/json-schema/epicdirectories-sweep-research-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/epicdirectories/refs/heads/main/json-schema/epicdirectories-update-public-listing-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/epicdirectories/refs/heads/main/json-schema/epicdirectories-create-directory-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/epicdirectories/refs/heads/main/json-schema/epicdirectories-update-directory-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/epicdirectories/refs/heads/main/json-schema/epicdirectories-create-public-listing-dto-schema.json

## Other EpicDirectories APIs (12)

- [EpicDirectories API Keys API](https://apis.io/apis/epicdirectories/epicdirectories-api-keys-api/)
- [EpicDirectories Attribute Templates API](https://apis.io/apis/epicdirectories/epicdirectories-attribute-templates-api/)
- [EpicDirectories Auth API](https://apis.io/apis/epicdirectories/epicdirectories-auth-api/)
- [EpicDirectories comments (admin) API](https://apis.io/apis/epicdirectories/epicdirectories-comments-admin-api/)
- [EpicDirectories comments (api key) API](https://apis.io/apis/epicdirectories/epicdirectories-comments-api-key-api/)
- [EpicDirectories Comments API](https://apis.io/apis/epicdirectories/epicdirectories-comments-api/)
- [EpicDirectories Directories API](https://apis.io/apis/epicdirectories/epicdirectories-directories-api/)
- [EpicDirectories Domains API](https://apis.io/apis/epicdirectories/epicdirectories-domains-api/)
- [EpicDirectories Health API](https://apis.io/apis/epicdirectories/epicdirectories-health-api/)
- [EpicDirectories Jobs API](https://apis.io/apis/epicdirectories/epicdirectories-jobs-api/)
- [EpicDirectories Listing Attributes API](https://apis.io/apis/epicdirectories/epicdirectories-listing-attributes-api/)
- [EpicDirectories Listings API](https://apis.io/apis/epicdirectories/epicdirectories-listings-api/)

## Tags

Public

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/epicdirectories/epicdirectories-public-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/epicdirectories/.