Pular para o conteúdo principal
GET
/
cms
/
v3
/
url-redirects
Obter redirecionamentos atuais
curl --request GET \
  --url https://api.hubapi.com/cms/v3/url-redirects/ \
  --header 'Authorization: Bearer <token>'
{
  "total": 2,
  "results": [
    {
      "id": "3212223134",
      "createdAt": "2017-07-24T17:24:09.141Z",
      "updatedAt": "2017-07-24T17:24:09.141Z",
      "routePrefix": "http://test.hs-sites.com/(?P<page_slug>.*)",
      "destination": "http://www.example.online/{page_slug}",
      "redirectStyle": 301,
      "isOnlyAfterNotFound": true,
      "isMatchFullUrl": true,
      "isMatchQueryString": false,
      "isPattern": false,
      "isTrailingSlashOptional": true,
      "isProtocolAgnostic": true,
      "precedence": 3
    },
    {
      "id": "3212242073",
      "createdAt": "2017-07-25T15:42:06.410Z",
      "updatedAt": "2017-07-25T15:42:06.410Z",
      "routePrefix": "/mytest/(?P<page_slug>.*)",
      "destination": "/newtest/{page_slug}",
      "redirectStyle": 301,
      "isOnlyAfterNotFound": true,
      "isMatchFullUrl": true,
      "isMatchQueryString": false,
      "isPattern": false,
      "isTrailingSlashOptional": true,
      "isProtocolAgnostic": true,
      "precedence": 999999993
    }
  ],
  "paging": {
    "next": {
      "after": "Mg%3D%3D",
      "link": "https://api.hubspot.com/cms/v3/url-redirects?after=Mg%3D%3D"
    }
  }
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Professional
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Starter

Autorizações

Authorization
string
header
obrigatório

The access token received from the authorization server in the OAuth 2.0 flow.

Parâmetros de consulta

after
string

O token do cursor de paginação do último recurso lido com sucesso será retornado como a propriedade JSON "paging.next.after" de uma resposta paginada que contém mais resultados.

archived
boolean

Se apenas os resultados que foram arquivados devem ser retornados.

createdAfter
string<date-time>

Retorne apenas os redirecionamentos criados após esta data.

createdAt
string<date-time>

Retorne apenas os redirecionamentos criados exatamente nesta data.

createdBefore
string<date-time>

Retorne apenas os redirecionamentos criados antes desta data.

limit
integer<int32>

Número máximo de resultados por página

sort
string[]

Um parâmetro de consulta para especificar a ordem em que os redirecionamentos de URL são retornados.

updatedAfter
string<date-time>

Retorne apenas redirecionamentos atualizados pela última vez após esta data.

updatedAt
string<date-time>

Retorne apenas redirecionamentos atualizados pela última vez exatamente nesta data.

updatedBefore
string<date-time>

Retorne apenas redirecionamentos atualizados pela última vez antes desta data.

Resposta

successful operation

results
object[]
obrigatório
total
integer<int32>
obrigatório

O número total de mapeamentos de URL disponíveis.

paging
object
Last modified on December 8, 2025