recipes

Create a new recipe

post/v1/directories/{directoryId}/recipes

Request

  • Base URL: https://api.epicdirectories.com
  • URL: https://api.epicdirectories.com/v1/directories/{directoryId}/recipes
  • Auth: HTTP bearer

Path parameters

directoryIdstring required

Request body

recipeTypestring required

Recipe type (e.g., collection, landing, feed)

slugstring required

URL-friendly slug

scopeobject required

Scope definition - filters for which listings to include

constraintsobject

Constraints for the recipe (e.g., limit, geo bounds)

rankingobject

Ranking/sorting configuration

seoobject

SEO metadata for the recipe output

Example request

{
  "slug": "top-restaurants-nyc",
  "scope": {
    "listingType": "restaurant",
    "taxonomyTerms": [
      "cuisine:italian"
    ]
  },
  "constraints": {
    "limit": 50,
    "radius": "10mi"
  },
  "ranking": {
    "sortBy": "rating",
    "order": "desc"
  },
  "seo": {
    "title": "Top Italian Restaurants in NYC",
    "metaDescription": "..."
  }
}

Response

Recipe created successfully

Changes

No recorded changes to this operation across all 1 revision of this API.