String docs
Site integrations

The Knot

The Knot wedding websites: both partners' full names, the wedding date and location, the site's page list, and the event schedule with venues, times and notes.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: theknot
  • Version: 1.0.0
  • Reads from: www.theknot.com
ActionDescriptionListed price
weddingRead a Knot wedding website's summary: both partners' full names, the wedding date or the season range the couple gave, the location, the registry note, privacy flags, and every page the site serves.Billed per request at your plan's rates
eventsRead a Knot wedding website's event schedule: every event and sub-event with its date, start and end times, venue name and address, attire, the couple's notes for guests, and RSVP flags.Billed per request at your plan's rates

wedding

Read a Knot wedding website's summary: both partners' full names, the wedding date or the season range the couple gave, the location, the registry note, privacy flags, and every page the site serves.

POST https://request.usestring.ai/v1/integrations/theknot/wedding

Input

Unknown fields are rejected.

FieldTypeDescription
slugstringRequired. The wedding website: its Knot slug, such as keaton-kroll-and-sarah-coates-sep-2026, or a theknot.com/us/<slug> URL. At least 1 character.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
slugstringThe website's Knot slug.
urlstringThe website's address.
firstNamestring | nullOne partner's first name.
lastNamestring | nullOne partner's last name.
fianceFirstNamestring | nullThe other partner's first name.
fianceLastNamestring | nullThe other partner's last name.
weddingDatestring | nullThe wedding date, as YYYY-MM-DD.
weddingDateRangeStartstring | nullFor a couple that gave a season rather than a day, the range's first day.
weddingDateRangeEndstring | nullFor a couple that gave a season rather than a day, the range's last day.
seasonstring | nullThe season the couple named, such as Fall 2026.
locationstring | nullThe wedding's city and state as the site shows them.
registryNotestring | nullThe couple's note about where they are registered.
countdownDaysinteger | nullDays until the wedding as the page counts them.
hidesDatebooleanThe couple asks the site not to show the date.
weddingUuidstring | nullThe wedding's Knot id.
coverPhotostring | nullThe site's cover photo.
searchEngineIndexablebooleanTrue when the site asks to be indexed, the flag that makes name search reach it.
pinProtectedbooleanTrue when the site asks guests for a PIN.
privateRsvpbooleanTrue when the RSVP form is invitation-only.
rsvpPageHiddenbooleanTrue when the RSVP page is hidden.
pagesobject[]The website's pages in nav order.
pages[].titlestringThe page's label, such as Our Wedding or Q + A.
pages[].typestringThe page's kind, such as WeddingPage or QAPage.
pages[].routestringThe page's path under the site's URL, empty for the home page.
pages[].urlstringThe page's address.
pages[].showbooleanTrue when the page is visible to guests.

Example

curl https://request.usestring.ai/v1/integrations/theknot/wedding \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "keaton-kroll-and-sarah-coates-sep-2026"
  }'

data starts with these rows:

[
  {
    "slug": "keaton-kroll-and-sarah-coates-sep-2026",
    "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026",
    "firstName": "Keaton",
    "lastName": "Kroll",
    "fianceFirstName": "Sarah",
    "fianceLastName": "Coates",
    "weddingDate": "2026-09-26",
    "weddingDateRangeStart": null,
    "weddingDateRangeEnd": null,
    "season": null,
    "location": "Las Vegas, NV",
    "registryNote": null,
    "countdownDays": null,
    "hidesDate": false,
    "weddingUuid": "0548dafa-1172-4480-99d3-3a2784545350",
    "coverPhoto": "https://www.theknot.com/tk-media/images/88de0f3e-cd39-4d06-ab4b-cfacc33d08ea~rt_0-cr_0.315.3000.1816?compress=true",
    "searchEngineIndexable": true,
    "pinProtected": false,
    "privateRsvp": true,
    "rsvpPageHidden": true,
    "pages": [
      {
        "title": "Our Wedding",
        "type": "WeddingPage",
        "route": "",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026",
        "show": true
      },
      {
        "title": "Q + A",
        "type": "QAPage",
        "route": "q-a",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026/q-a",
        "show": true
      },
      {
        "title": "Lodging & Travel",
        "type": "TravelPage",
        "route": "travel",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026/travel",
        "show": true
      },
      {
        "title": "Our Story",
        "type": "StoryPage",
        "route": "our-story",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026/our-story",
        "show": false
      },
      {
        "title": "Wedding Party",
        "type": "WeddingPartyPage",
        "route": "wedding-party",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026/wedding-party",
        "show": false
      },
      {
        "title": "Things to Do",
        "type": "ThingsToDoPage",
        "route": "things-to-do",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026/things-to-do",
        "show": true
      },
      {
        "title": "Registry",
        "type": "RegistryPage",
        "route": "registry",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026/registry",
        "show": true
      },
      {
        "title": "Photos",
        "type": "PhotoPage",
        "route": "photos",
        "url": "https://www.theknot.com/us/keaton-kroll-and-sarah-coates-sep-2026/photos",
        "show": true
      }
    ]
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

events

Read a Knot wedding website's event schedule: every event and sub-event with its date, start and end times, venue name and address, attire, the couple's notes for guests, and RSVP flags.

POST https://request.usestring.ai/v1/integrations/theknot/events

Input

Unknown fields are rejected.

FieldTypeDescription
slugstringRequired. The wedding website: its Knot slug, such as keaton-kroll-and-sarah-coates-sep-2026, or a theknot.com/us/<slug> URL. At least 1 character.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
positionintegerThe event's place in the schedule, from 1, sub-events ordered under their entry.
idstringThe event's Knot id.
namestringWhat the couple calls it, such as Wedding Day or Ceremony.
typestringThe event's kind, such as WeddingDay or WeddingEvent.
parentstring | nullThe schedule entry this sub-event belongs to, when it is one.
datestring | nullThe event's day, as YYYY-MM-DD.
timestring | nullWhen it starts.
endTimestring | nullWhen it ends.
attirestring | nullThe dress code the couple set.
notesstring | nullThe couple's notes for guests, such as directions or venue instructions.
venueNamestring | nullThe venue's name.
venueAddressstring | nullThe venue's full address as the couple wrote it.
requireRsvpbooleanGuests must RSVP to this event.
sameVenuebooleanThe event shares the day's venue.
visiblebooleanTrue when the event shows on the site.

Example

curl https://request.usestring.ai/v1/integrations/theknot/events \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "keaton-kroll-and-sarah-coates-sep-2026"
  }'

data starts with these rows:

[
  {
    "position": 1,
    "id": "c3bc694e-b160-478b-bdcd-19bfcb644552",
    "name": "Wedding Day",
    "type": "WeddingDay",
    "parent": null,
    "date": "2026-09-26",
    "time": "18:00",
    "endTime": "22:00",
    "attire": "Formal",
    "notes": null,
    "venueName": null,
    "venueAddress": null,
    "requireRsvp": false,
    "sameVenue": false,
    "visible": true
  },
  {
    "position": 2,
    "id": "ecc2bef5-d382-4c5e-85fb-e7c30908caaa",
    "name": "Guest Seating",
    "type": "WeddingEvent",
    "parent": "Wedding Day",
    "date": "2026-09-26",
    "time": "17:30",
    "endTime": null,
    "attire": null,
    "notes": "The Venetian  ~ Seating entrance will end promptly at 5:55pm.",
    "venueName": null,
    "venueAddress": null,
    "requireRsvp": false,
    "sameVenue": false,
    "visible": true
  },
  {
    "position": 3,
    "id": "8ed1839a-b2b8-49bf-8c1a-4827e458c501",
    "name": "Ceremony",
    "type": "WeddingEvent",
    "parent": "Wedding Day",
    "date": "2026-09-26",
    "time": "18:00",
    "endTime": "18:15",
    "attire": null,
    "notes": "The Venetian",
    "venueName": null,
    "venueAddress": null,
    "requireRsvp": false,
    "sameVenue": false,
    "visible": true
  },
  {
    "position": 4,
    "id": "0bb7cbc2-e6fc-4426-9d1f-be0d72c8428c",
    "name": "RECEPTION",
    "type": "WeddingEvent",
    "parent": "Wedding Day",
    "date": "2026-09-26",
    "time": "19:00",
    "endTime": "22:00",
    "attire": null,
    "notes": "Mercato Della Pescheria📍Located within the Grand Canal Shoppes at The Venetian. Upon arrival to the host stand, please mention the Kroll Wedding and the staff will direct you.",
    "venueName": null,
    "venueAddress": null,
    "requireRsvp": false,
    "sameVenue": false,
    "visible": true
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.