Content Library Object

Property

Description

location_data object

Contains location-specific data for the primary location associated with a site.

See the section below for details.

additional_locations
object

Contains location-specific data for any secondary/child locations associated with a site.

See the section below for details.

site_texts
object

Contains the standard and custom text strings. Each field has a max length of 4000 characters. There is a limit of 200 site_text per site.

See the section below for details.

business_data
object

Contains the name of the business, the primary logo_url and fields used to populate Duda's AI assistant.

See the section below for details.

site_images
object

Images that can be set and used within the design of the website. If you have the data, you should populate the alt value.

See the section below for details.

Location Specific Information

The following fields are related to a specific location in the content library.

location_data & additional_locations

Property

Description

phones object[]

Contains phone numbers for this location. The object allows for a friendly label name and the actual phone number. Note that there is no specific requirement for phone numbers, Duda will display this in the same format you submit it in. Max 80 characters each.

See the section below for details.

emails
object[]

Contains all email addresses associated with this location. The object allows for a friendly label name and the actual email address. Max 80 characters each.

See the section below for details.

label
string

A simple name for this location. This is displayed in the Duda Content Library UI related to this location. Max 80 characters.

schema
object

Details of the location/organizational schema that's generated. Note: only available as a property forlocation_data, setting schema properties for additional_locations is not currently supported.

social_accounts
object

The profile name of this location's social networks. You must pass only the profile name/ID. Do not pass the full URL (e.g., https://wwwfacebook.com/duda). We support the following social networks: Facebook, Twitter, Yelp, Foursquare, Google Plus, Instagram, Youtube, Linkedin, Pinterest, Vimeo, RSS, Reddit, Trip Advisor & Snapchat.

See the section below for details.

address
object

Contains all fields required to display an address: streetAddress, postalCode, region, city, country.

See the section below for details.

address_geolocation
string

A geocode address string used to get LAT/LON from a geocoding map service. This is generated within the Duda Editor UI when searching for an address. Note: You can't update the geolocation string via the API (you can only read it).

geo
object

An object containing the LAT and LON of the address. Duda will return this if we've identified an address in the editor for this location, but we will not automatically generate it. You can pass this if you know the exact LAT/LON.

logo_url
string

A URL directly referencing the logo of this location. Must be a public URL and be served over HTTPS.

business_hours
object[]

An array containing each day of the week and the hours that the location opens and closes. For each set of hours, you can pass an array of days: MON, TUE, WED, THU, FRI, SAT, SUN that applies to those hours. Open and close hours must be in 24HH:MM format. So, for example, 7:30 am would be: 07:30 and 5 pm would be 17:00. If the business is closed on a certain day, please omit it from the data set. If the business is open 24 hours a day, you should pass the hours as 00:00 to 24:00.

See the section below for details.

phone

Property

Description

phoneNumber string

A specific phone number.

label
string

A label to associate with the above phone number.

email

Property

Description

emailAddress string

A specific email address.

label
string

A label to associate with the above email address.

schema

Property

type string

The type of LocalBusinessSchema for this business. Full list of types can be found here.

custom_fields
array of objects

An array of objects with name and value properties for additional schema fields. This allows you to add any schema fields that Duda does not support via the content library data.

social_accounts

Property

Description

tripadvisor string

A TripAdvisor page ID. Max 200 characters.

youtube
string

A YouTube page ID. Max 50 characters.

facebook
string

A Facebook page ID. Max 200 characters

yelp
string

A Yelp page ID. Max 300 characters

pinterest
string

A Pinterest page ID. Max 200 characters.

linkedin
string

A Linkedin page ID. Max 200 characters.

instagram
string

An Instagram page ID. Max 60 characters.

snapchat
string

A Snapchat page ID. Max 30 characters.

twitter
string

A Twitter/X page ID. Max 300 characters.

rss
string

A link to the site's RSS feed. Max 2048 characters.

vimeo
string

A Vimeo page ID. Max 200 characters

reddit
string

A Reddit page ID. Max 200 characters

foursquare
string

A Foursquare page ID. Max 200 characters

google_my_business
string

A Google Business ID. Max 200 characters

whatsapp
string

A WhatsApp ID. Max 50 characters

tiktok
string

A TikTok ID. Max 50 characters

address

Property

Description

streetAddress string

The business's street address.

postalCode
string

The business's postal code.

region
string

The region where the business is located.

city
string

The city where the business is located.

country
string

The counter where the business is located.

geo

Property

Description

longitude string

latitude
string

business_hours

Property

Description

days string[]

[ "MON", "TUE", "WED", "THU", "FRI" ]

open
string

The time the business opens.

close
string

The time the business closes.

Global Properties

Below is website content that does not relate to a specific location. This is global data stored across the website.

Property

Description

business_data object

Contains the name of the business, the primary logo_url and fields used to populate Duda's AI assistant. See the section below for details

site_texts
object

Containing overview, services, about_us and custom text strings. Each field has a max length of 4000 characters. There is a limit of 200 site_text per site. See the section below for details

site_images
object[]

Images that can be set and used within the design of the website. If you have the data, you should populate the alt value. See the section below for details

business_data

The business data object contains visible content for the site such as the name and logo of the business, and also contains data that is used by Duda's AI assistant to generate appropriate prompts

Property

Description

name string

The name of the business. This field is required if you are also providing the AI assistant fields listed below.

logo_url
string

A URL to the overall business logo.

description
string

The description of the business. This field is used solely by the Duda AI Assistant to generate relevant prompts for AI content. Max 5000 characters

category
string

The category of the business. This field is used solely by the Duda AI Assistant to generate relevant prompts for AI content. Max 500 characters

service_area
string

The service area of the business. This field is used solely by the Duda AI Assistant to generate relevant prompts for AI content. Any description of a service area is allowed, and is not limited to a specific address. Max 500 characters

tone_of_voice
string enum

One of CONVERSATIONAL, HUMOROUS, ENTHUSIASTIC, INFORMATIVE, PROFESSIONAL, WITTY or AUTHORITATIVE. This field is used solely by the Duda AI Assistant to generate relevant prompts for AI content. Any other value outside of the enum will result in a parse error.

data_controller
string

The name of the person or organization determining the means by which the data is processed. Used for GDPR.

site_texts

Property

Description

overview string

Overview of the business. Up to 4000 characters.

services
string

List of services. Up to 4000 characters.

about_us
string

About the business. Up to 4000 characters.

custom
object[]

An array of key/value pairs of custom text to be used as site content. Each object in the array consists of a label and text property.

site_images

Property

Description

label string

Identifier for image in the content library. Used when connecting this image to widgets. Max 80 characters.

url
string

A URL to the image.

alt
string

A description of the image used by screen readers and other assistive technologies. Max 80 characters.

Example Payload

{
  "location_data":{
    "phones":[
      {
        "phoneNumber":"123-123-1234",
        "label":"Russ Phone"
      },
      {
        "phoneNumber":"18001234567",
        "label":"Duda Phone"
      }
    ],
    "emails":[
      {
        "emailAddress":"[email protected]",
        "label":"API Email"
      },
      {
        "emailAddress":"[email protected]",
        "label":"Support Email"
      }
    ],
    "schema": {
      "type": "Resort",
      "custom_fields":[
        {
          "name":"acceptsReservations",
          "value":true
        },
        {
          "name":"priceRange",
          "value":"$$$"
        }
      ]
    },
    "label":"Duda HQ",
    "social_accounts":{
      "tripadvisor":"Restaurant_Review-g32849-d2394400-Reviews-Oren_s_Hummus_Shop-Palo_Alto_California.html",
      "youtube":"UCPMwzOc1Su-s2z-J1xiU9ig",
      "facebook":"duda",
      "yelp":"orens-hummus-shop-palo-alto",
      "pinterest":"michelleobama",
      "google_plus":"+Dudamobile577",
      "linkedin":"duda",
      "instagram":"orenshummus",
      "snapchat":"michelleobama",
      "twitter":"dudamobile",
      "rss":"https://www.duda.co/blog/feed/",
      "vimeo":"dudamobile",
      "reddit":"duda"
    },
    "address":{
      "streetAddress":"577 College Ave",
      "postalCode":"94306",
      "region":"CA",
      "city":"Palo Alto",
      "country":"US"
    },
    "address_geolocation":"1833 Harvard St NW, Washington, DC 20009, USA",
    "geo":{
      "longitude":"-122.4757527166",
      "latitude":"37.502439189002"
    },
    "logo_url":"https://du-cdn.multiscreensite.com/duda_website/img/home/agencies.svg",
    "business_hours":[
      {
        "days":[
          "MON",
          "TUE",
          "WED",
          "THU",
          "FRI"
        ],
        "open":"09:00",
        "close":"18:00"
      }
    ]
  },
  "additional_locations":[
    {
      "uuid":"276169839",
      "phones":[
        {
          "phoneNumber":"123-123-1234",
          "label":""
        }
      ],
      "emails":[
        
      ],
      "label":"Duda Tel Aviv",
      "social_accounts":{
        
      },
      "address":{
        
      },
      "geo":{
        "longitude":"34.78337",
        "latitude":"32.07605"
      },
      "logo_url":null,
      "business_hours":null
    }
  ],
  "site_texts":{
    "overview":"Oh, Duda? Duda is a variation of \"Dude\", who just happens to be the main character in one of our favorite movies of all time: The Big Lebowski. You should watch it some time. Look out for that ferret!",
    "services":"- Responsive Website Builder",
    "custom":[
      {
        "label":"Example CTA 1",
        "text":"THE WEB DESIGN PLATFORM FOR Scaling Your Agency"
      },
      {
        "label":"Example CTA 2",
        "text":"THE WEB DESIGN PLATFORM FOR\nBuilding Websites Faster"
      }
    ],
    "about_us":"Duda is a leading website builder for web professionals and agencies of all sizes. Our website builder enables you to build amazing, feature-rich websites that are perfectly suited to desktop, tablet and mobile. Our mobile builder enables you to build mobile-only sites from scratch, or based on an existing desktop site or Facebook business page. Duda allows professionals and agencies to build high-converting, personalized websites at scale. Duda optimizes each and every site for Google PageSpeed."
  },
  "business_data":{
    "name":"Duda",
    "logo_url":"https://www.duda.co/developers/REST-API-Reference/images/duda.svg",
    "description": "A responsive website builder built for web professionals",
    "category": "Software",
    "service_area": "A 30 mile radius from Boulder, Colorado",
    "tone_of_voice": "CONVERSATIONAL",
    "data_controller": "Org"
  },
  "site_images":[
    {
      "label":"Example Store Logo",
      "url":"https://irt-cdn.multiscreensite.com/7536fe2010ed4f7ea68e21d0cb868e01/dms3rep/multi/ice_cream_logo_b_w-18-300x300.svg",
      "alt":"Example Store Logo"
    },
    {
      "label":"Example Store Banner",
      "url":"https://irt-cdn.multiscreensite.com/7536fe2010ed4f7ea68e21d0cb868e01/dms3rep/multi/sign_icecream_shop-1000x1108.jpg",
      "alt":"Example Store Banner"
    }
  ]
}