Redirect

Version 2019-10
A redirect causes a visitor on a specific path on the shop's site to be automatically sent to a different location, called the target. The target can be a new path on the shop's site or a full URL. The new URL can even be on a completely different domain. Redirect paths are unique, so a shop can't have more than one redirect with the same path.

What you can do with Redirect

The Shopify API lets you do the following with the Redirect resource. More detailed versions of these general actions may be available:

Redirect properties

id
read-only
"id": 304339089

The ID for the redirect.

path
"path": "/products.php"

The old path to be redirected. When the user visits this path, they will be redirected to the target. (maximum: 1024 characters)

target
"target": "/products"

The target location where the user will be redirected. When the user visits the old path specified by the path property, they will be redirected to this location. This property can be set to any path on the shop's site, or to an external URL. (maximum: 255 characters)

Endpoints

GET /admin/api/2019-10/redirects.json
Retrieves a list of URL redirects. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
limit

The maximum number of results to show.

(default: 50, maximum: 250)
since_id

Restrict results to after the specified ID.

path

Show redirects with a given path.

target

Show redirects with a given target.

fields

Show only certain fields, specified by a comma-separated list of field names.

Retrieve a list of all redirects

GET /admin/api/2019-10/redirects.json