The endpoint is:
We encourage you to explicitly request this version via the Accept header.
All API access is over HTTPS, and accessed from the
api.weebly.com domain. All data is sent and received as JSON. Blank fields are included as null instead of being omitted. Dates and times are Unix Epoch timestamps.
When retrieving a list of resources, a summary list view of each resource is returned. In some cases, this is akin to a compound primary key. In most root resource cases, like product, the list view contains enough information to make a workable list view in an application without making calls for each resource.
When retrieving a single resource, you will receive a detailed view typically resulting in all the attributes of the resource. In addition, sub resources (like a product’s skus) that are owned by this resource are inlined to the result. Other resources (like categories) which are associated but not owned by this resource provide the ids needed to look them up separately.
We may issue redirects. Any call may result in a redirect, at which point you should make an identical call but to the newly provided resource URL.
You can use the following:
- GET Used for retrieving resources.
- POST Used for creating resources.
- PATCH Used for updating resources with partial JSON data.
- PUT Used for replacing resources or entire collections. Fields will be replaced with given values and any fields without given values will be reset to their default. Any fields without defaults, for example ID fields, will remain unchanged.
- DELETE Used for deleting resources.
Some endpoints allow you to use search parameters in order to filter your results. When using parameters, do not add that query string to your HMAC Hash.
Pagination of certain resources in list view happens automatically. Information about the total number of resources, like the total count, are provided in headers.
X-Resultset-Totalshows the total number of records for the request.
X-Resultset-Pageshows the page for the call.
X-Resultset-Limitshows the record limit for the page (i.e. each call). The default is
25, the max is
If there are additional pages to be returned, a
Link header will be included that has links to the first, previous, next and last pages.
For example, a response from the Site API might return the following in the header, showing that there are a total of 44 records to be returned, this is the first page, and that 25 is the record limit:
When you expect the result set to be greater than 25, use these parameters to determine the pages to return and to increase the limit:
page(int) Which page of results to return. Starts at
limit(int) Number of results per page. Default
200. Don’t forget that raising the limit may affect performance.
For example, this CURL request to the Site API returns the second page of result sets.
To access the Weebly API, you will need to authenticate using OAuth, allowing you to access resources based on a particular user and site. After the OAuth flow, you will have a token for that user and site, and you must use it in the header to authenticate all requests. Examples in the API docs show how to add this to the header.
Authenticating with invalid credentials will return
401 Unauthorized, and continued failures will result in
When you configure OAuth, you need to declare the scope of information your app needs access to. These scopes determine the permissions that the user will need to grant in order for your app to access the API on their behalf. Each endpoint notes the required scope.