Early access

Partner API

For ordering, POS and reservation platforms that bring their restaurants to CreatoRain. Your system enrolls each store with one call, then reads that store's creator bookings and published videos. The Partner API is in early access: access is by request, and we issue your API key when your request is approved.

Read the Docs

Running a restaurant? CreatoRain runs the campaign for you. See pricing.

What the API does

Enroll your stores, manage them, and read what happens at each one.

  • Enroll and manage stores

    Enroll a store with your own ID for it, plus its name and address. Later you can change its details, pause it, resume it or end it. Sending the same enrollment twice is safe: you get the same store back.

  • Opening hours, found for you

    Send a store's opening hours, or leave them out and we look them up. A store whose hours can't be found is on hold until they are known.

  • Creator bookings

    Read every booking at a store, or across all your stores: its status, the visit time in the store's time zone, the party size, and the creator's handle, platforms and follower count. No guest or creator contact details are returned.

  • Published videos

    Read the videos creators posted for each store: the link, the platform and when it went up. View and like counts are coming.

From enrollment to a posted video

An example sequence of sandbox calls for a test store, from enrollment to the posted video. Beside it is the JSON response from the content read.
An example sequence of sandbox calls for a test store. One call enrolls the store, and reads return each booking and video. The picture shows sample data.

  1. Enroll the store

    POST /locations with your ID, the name and the address.

  2. Set it up

    We find the opening hours if you didn't send them. A store with no known hours is on hold.

  3. Invite creators from our network

    Our team invites creators from our 300,000+ food-creator network.

  4. Book a visit

    The creator picks a date and time; the booking is confirmed.

  5. Visit

    The booking ends as completed, or as no_show.

  6. Post the video

    The video appears in GET /locations/{partner_location_id}/content.

  7. Read it back

    Bookings, videos, /summary and monthly counts, whenever you want them.

Simple integration

Send your API key as a Bearer token, send JSON, and get JSON back.

  • One base path, /partner/v1, with JSON requests and responses
  • Errors as { "error": { "code", "message" } } with standard HTTP status codes
  • 600 requests a minute per key by default, RateLimit headers on responses, and a Retry-After header on a 429
View Full Documentation
curl -X POST "$CREATORAIN_API_BASE/locations" \
  -H "Authorization: Bearer $CREATORAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_location_id": "store_123",
    "name": "Example Noodle House",
    "address": {
      "line1": "100 Main St",
      "city": "San Jose",
      "state": "CA",
      "postal_code": "95113",
      "country": "US"
    }
  }'

Ready to connect your platform?

Book a call with our team to request access.