---
title: "List creators"
method: POST
path: "/api/v1/tools/list_creators"
tags: ["default"]
---

# List creators

`POST /api/v1/tools/list_creators`

## Request

- Base URL: `https://www.affiliatespy.io`
- URL: `https://www.affiliatespy.io/api/v1/tools/list_creators`
- Auth: HTTP bearer

Creators for an app, sanitized: contact VALUES are hidden until revealed with reveal_contact (revealed emails are included). graded:false marks a preview row not graded yet (grade and score null). Sorted by score descending unless `sort` is set. Paginate with limit/offset; response includes total after filters.

## Request body

- object
  - `app_id` string, uuid: App to list creators for. Omit to use your most recently added app (see list_apps).
  - `platform` 'tiktok' | 'youtube' | 'instagram'
  - `min_score` number: Minimum quality score, 0-100.
  - `proven_partner` boolean: Only creators with proof of a paid competitor partnership.
  - `has_contact` boolean: Only creators with an email on file (value hidden until revealed).
  - `saved` boolean: Only creators you saved.
  - `search` string: Substring match on handle, name, or bio.
  - `sort` 'score' | 'followers' | 'avg_views': Default: score.
  - `limit` integer: Default 50, max 100.
  - `offset` integer

## Response `200`

The tool's JSON result (same payload the MCP tool returns).

- unknown

## Other responses

- `400`: Arguments failed validation; body lists the issues.
- `401`: Missing or invalid API key.
- `403`: Guarded tool with Unrestricted MCP off.
- `429`: Rate limited (60 requests per minute per key).

---

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