---
title: "Suggest starter lead searches"
method: GET
path: "/find-leads/suggestions/"
tags: ["find-leads"]
---

# Suggest starter lead searches

`GET /find-leads/suggestions/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/find-leads/suggestions/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

A few ready-to-load searches, all targeting the given record type. Written from the workspace's business context when it has one (tailored is true); otherwise a standard set every workspace gets (tailored is false). Suggestions are recipes: nothing runs and nothing is spent until one is loaded and acted on. Buying-signal searches are built from their own picker, so they come back with an empty list rather than an error.

## Query parameters

- `record_type` 'people' | 'companies' | 'signal_companies' | 'signal_people' | 'lookalikes' | 'local_businesses' | 'hiring_companies' | 'backlinks' | 'search_results' | 'post_authors', required: Which dataset a search runs against, and so which provider serves it. Values are persisted in String(16) columns, so every member must stay within 16 characters.

## Response `200`

Successful Response

- LeadSearchSuggestionListResponseSchema: Starter searches worth clicking before any filters exist.
  - `suggestions` LeadSearchSuggestionSchema[], required
    - `label` string, required
    - `query` object, required
    - `record_type` 'people' | 'companies' | 'signal_companies' | 'signal_people' | 'lookalikes' | 'local_businesses' | 'hiring_companies' | 'backlinks' | 'search_results' | 'post_authors', required: Which dataset a search runs against, and so which provider serves it. Values are persisted in String(16) columns, so every member must stay within 16 characters.
  - `tailored` boolean, required: True when the suggestions were written from the workspace's business context. False for the standard starters every workspace gets while its business context is empty, or when nothing tailored could be written from it.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)