---
title: "Search Links"
method: GET
path: "/links/search"
tags: ["Links"]
---

# Search Links

`GET /links/search`

## Request

- Base URL: `https://api.rebrandly.com/v1`
- URL: `https://api.rebrandly.com/v1/links/search`
- Auth: API key in header `apikey`

Search for links with advanced filtering by term, domain, tag, and more.

**Requires:** Authenticated user with workspace access.

**Authorization:**

## Query parameters

- `term` string
- `domain.id` string
- `tag.id` string
- `limit` integer
- `last` string

## Headers

- `Workspace` string
- `apikey` string, required

## Response `200`

Search results

- Link[]
  - `id` string, required: Link public ID (link_public_id)
  - `title` string: Human-readable title for the link
  - `slashtag` string, required: URL path component
  - `destination` string, uri, required: Target URL where the link redirects
  - `shortUrl` string, required: Complete short URL (domain + slashtag)
  - `domainId` string: Public ID of the domain used
  - `domainName` string: Full domain name
  - `domain` object: Domain object with details
    - `id` string
    - `ref` string
    - `fullName` string
    - `sharing` object
  - `clicks` integer: Number of clicks on the link
  - `createdAt` string, date-time, required: Timestamp when link was created
  - `updatedAt` string, date-time, required: Timestamp when link was last updated
  - `status` 'active' | 'deleted' | 'blocked', required: Link status
  - `description` string: Link description (only if links.notes feature is enabled)
  - `workspace` object: Workspace information
    - `id` string: Workspace public ID
  - `https` boolean: Whether the link supports HTTPS

---

[API](https://skmtc.dev/rebrandly/apis/rebrandly-api.md) - [All operations](https://skmtc.dev/rebrandly/apis/rebrandly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rebrandly/apis/rebrandly-api/revisions/b098bf9fb684?raw)