Social Fetch
Start for freeStart free
Shopify hub

Shopify Redirects API

The store's published redirect table, one path pair at a time.

GET /v1/shopify/store/redirects

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/shopify/store/redirects?store=… returns data.redirects, each with id, path and target. path is the old URL path and target is where the store redirects it. Use limit and cursor to walk the table.

The table can be empty on a new storefront. That is a found answer with an empty list, not a missing store.

Shopify Redirects API FAQ

What is a redirect row?

It is a pair of paths: path is the old URL and target is the destination the store publishes for it.

Does it include query strings?

The store publishes paths. Query-string handling depends on how the merchant configured each redirect.

How do I page?

Read page.hasMore and pass page.nextCursor back as cursor with the same filters.

How do I name the store?

The store is the domain, for example allbirds.com, www.allbirds.com or weareallbirds.myshopify.com. A full URL is reduced to its host.

How is it billed?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

What does lookupStatus mean?

found means the lookup succeeded. not_found means the store or entity does not exist or is not a Shopify store. private means the storefront is password-protected. restricted means it is paused or frozen. HTTP 200 only means the request finished, so branch on lookupStatus.

Other Shopify endpoints