---
title: "Find creators to work with"
method: GET
path: "/v1/discover/creators"
tags: ["Discovery"]
---

# Find creators to work with

`GET /v1/discover/creators`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/discover/creators`
- Auth: `bearerAuth` (a scheme the document does not define)

Search Meta creator discovery for people a brand could partner with. A Facebook Page searches Facebook Creator Discovery directly. An Instagram account connected through Facebook searches Instagram Creator Marketplace. Entries marked `sample: true` are test data, not real outreach targets.

## Query parameters

- `account` string, required
- `q` string
- `countries` string
- `limit` integer
- `cursor` string

## Response `200`

Creators

- object
  - `items` object[], required
    - `id` string, required
    - `handle` string, required
    - `displayName` string, nullable
    - `avatarUrl` string, nullable
    - `bio` string, nullable
    - `categories` string[]
    - `country` string, nullable
    - `portfolioUrl` string, uri, nullable: Individual creator profile URL. Null for Meta test results.
    - `platforms` string[]
    - `verified` boolean, nullable
    - `hasBrandPartnershipExperience` boolean, nullable
    - `followsBrand` boolean, nullable
    - `sample` boolean, required: True until PostLake has Meta Advanced Access configured. Never use a sample result for outreach.
  - `cursor` string, nullable, required
  - `platform` 'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest', required

## Other responses

- `401`: Unauthorized
- `409`: The network refused, and retrying will not help. A brand that has not accepted the relevant Meta creator-product terms answers `creator_marketplace_not_onboarded`. `retryable` is false and `fix` carries the exact Facebook or Instagram click path. Check `discovers.creators` and `blocked` on GET /v1/social-accounts/{id} first and you can avoid this call entirely.

---

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