EpicDirectories Source Snapshots API

The source-snapshots API from EpicDirectories — 3 operation(s) for source-snapshots.

Documentation GitHub OpenAPI

Operations 5

POST /v1/directories/{directoryId}/listings/{listingId}/snapshots Create a source snapshot for a listing #

GET /v1/directories/{directoryId}/listings/{listingId}/snapshots List source snapshots for a listing #

GET /v1/directories/{directoryId}/listings/{listingId}/snapshots/latest/{source} Get latest snapshot for a specific source #

GET /v1/directories/{directoryId}/listings/{listingId}/snapshots/{snapshotId} Get a specific snapshot #

DELETE /v1/directories/{directoryId}/listings/{listingId}/snapshots/{snapshotId} Delete a snapshot #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/epicdirectories/openapi/epicdirectories-source-snapshots-api-openapi.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/epicdirectories/json-schema/epicdirectories-create-source-snapshot-dto-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/epicdirectories:epicdirectories-source-snapshots-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: EpicDirectories Source Snapshots API
  description: API-first directory data platform.
  version: '1.0'
  contact: {}
servers:
- url: https://api.epicdirectories.com
  description: Production
- url: http://localhost:3333
  description: Local development
tags:
- name: source-snapshots
paths:
  /v1/directories/{directoryId}/listings/{listingId}/snapshots:
    post:
      operationId: SourceSnapshotsController_create
      summary: Create a source snapshot for a listing
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSourceSnapshotDto'
      responses:
        '201':
          description: Snapshot created successfully
      tags:
      - source-snapshots
      security:
      - bearer: []
    get:
      operationId: SourceSnapshotsController_findAll
      summary: List source snapshots for a listing
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      - name: source
        required: false
        in: query
        description: Filter by source
        schema:
          type: string
      responses:
        '200':
          description: List of snapshots
      tags:
      - source-snapshots
      security:
      - bearer: []
  /v1/directories/{directoryId}/listings/{listingId}/snapshots/latest/{source}:
    get:
      operationId: SourceSnapshotsController_findLatestBySource
      summary: Get latest snapshot for a specific source
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      - name: source
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Latest snapshot for source
        '404':
          description: No snapshot found for source
      tags:
      - source-snapshots
      security:
      - bearer: []
  /v1/directories/{directoryId}/listings/{listingId}/snapshots/{snapshotId}:
    get:
      operationId: SourceSnapshotsController_findOne
      summary: Get a specific snapshot
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      - name: snapshotId
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Snapshot details
        '404':
          description: Snapshot not found
      tags:
      - source-snapshots
      security:
      - bearer: []
    delete:
      operationId: SourceSnapshotsController_remove
      summary: Delete a snapshot
      parameters:
      - name: directoryId
        required: true
        in: path
        schema:
          type: string
      - name: listingId
        required: true
        in: path
        schema:
          type: string
      - name: snapshotId
        required: true
        in: path
        schema:
          type: string
      responses:
        '204':
          description: Snapshot deleted successfully
        '404':
          description: Snapshot not found
      tags:
      - source-snapshots
      security:
      - bearer: []
components:
  schemas:
    CreateSourceSnapshotDto:
      type: object
      properties:
        source:
          type: string
          description: Source identifier (e.g., google_places, yelp, manual)
          example: google_places
        externalId:
          type: string
          description: External ID from the source system
          example: ChIJN1t_tDeuEmsRUsoyG83frY4
        payload:
          type: object
          description: Raw payload data from the source
          example:
            name: Business Name
            rating: 4.5
        fetchedAt:
          type: string
          description: When the data was fetched from source (ISO 8601)
          example: '2024-01-15T10:30:00Z'
      required:
      - source
      - payload
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
x-provenance:
  method: harvested
  publisher: EpicDirectories
  source: https://api.epicdirectories.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)