Catalog Download

This guide explains how to download the EveryBite catalog snapshot from private S3 storage.

You do not need an AWS account or AWS credentials. The temporary URL returned by EveryBite carries its own signature.

Arguments

Argument	Type	Required	Description
`businessId`	`NonEmptyString!`	Yes	The business whose snapshot you want. Determines the S3 object key the download URL points at.
`catalogDate`	`String`	No	Snapshot date in `YYYY-MM-DD` form. Defaults to the current UTC date.

businessId has no default. Omitting it is a GraphQL validation error and the request is rejected before it reaches the resolver. An empty string is rejected by the NonEmptyString scalar.

The value is used verbatim and is not validated for format. A malformed businessId produces a malformed object key rather than an error, so the request reads from the wrong location instead of failing. Always check objectKey in the response to confirm what was read.

Request a download URL

Use the EveryBite-issued bearer token:

curl --request POST \
  "https://api.everybite.com/graphql" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${EVERYBITE_<provider-name>_TOKEN}" \
  --data '{
    "query": "query { <provider-name>CatalogDownload(businessId: \"73878\") { status downloadUrl objectKey catalogDate expiresAt contentType } }"
  }'

When catalogDate is omitted, EveryBite uses the current UTC date. To request a specific date:

query {
  <provider-name>CatalogDownload(businessId: "73878", catalogDate: "2026-07-24") {
    status
    downloadUrl
    objectKey
    catalogDate
    expiresAt
    contentType
  }
}

Example ready response:

{
  "data": {
    "<provider-name>CatalogDownload": {
      "status": "READY",
      "downloadUrl": "https://everybite-exchange-<provider-name>.s3.us-east-1.amazonaws.com/...?X-Amz-Signature=...",
      "objectKey": "everybite/business_id=73878/date=2026-07-24/catalog-snapshot.json",
      "catalogDate": "2026-07-24",
      "expiresAt": "2026-07-24T15:30:00.000Z",
      "contentType": "application/json"
    }
  }
}

The object key is derived from the businessId you supplied:

everybite/business_id=<businessId>/date=<YYYY-MM-DD>/catalog-snapshot.json

If no completed snapshot exists for that business and date, status is NOT_FOUND and downloadUrl is null.

Download the snapshot

Copy only the complete downloadUrl value from the response.

curl --fail --show-error \
  --output catalog-snapshot.json \
  "<paste-the-complete-downloadUrl-here>"

The downloaded file is the EveryBite response for the selected brand and catalog date.

Handling the download URL

The temporary URL normally expires after approximately 15 minutes. Keep it quoted, do not modify it, and request a new URL if it expires.

Overview

Core Concepts

SmartMenu API

GuestIQ

Atlas

Arguments

Handling the download URL

​Arguments

​Handling the download URL

Arguments

Handling the download URL