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

# Search

`GET /search`

## Request

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

Search links and domains in the workspace.

## Query parameters

- `term` string
- `linksLimit` integer
- `domainsLimit` integer
- `mode` 'strict' | 'flexible'

## Headers

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

## Response `200`

Search results

- object
  - `links` 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
  - `domains` Domain[]
    - `id` string, required: Domain public ID
    - `fullName` string, required: Full domain name
    - `topLevelDomain` string: TLD
    - `type` 'USER' | 'SYSTEM'
    - `status` object
      - `dns` 'verified' | 'unverified' | 'verifying'
      - `subscription` 'active' | 'inactive' | 'pending'
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

---

[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)