Browse Club creators for a campaign

Lists Scouty Club creators who fit one live campaign and are not on it yet, best fit first, 24 a page. Each creator is a card: a first name and last initial, country, niches, platforms, reach and engagement bands, experience and fit. It never gives a handle, a link, a full name or any way to contact a creator: invite them with scouty_invite_creators and Scouty messages them for you. Filters narrow the list; there is no search by name.

GEThttps://api.tryscouty.com/v1/campaigns/{campaignId}/club

Scopecreators:read
Read
MCP toolscouty_browse_club

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. The token needs the creators:read scope, or the call answers 403 insufficient_scope. Tokens and scopes

Authorization: Bearer $SCOUTY_TOKEN

Path parameters

Name	Type	Required	Description
`campaignId`	`integer`	Required	The live campaign.

Query parameters

Name	Type	Required	Description
`niche`	`string`	Optional	Only creators with one of these niches, comma-separated: Career, College, Productivity, Tech / AI, Finance, Lifestyle, Fitness, Beauty, Fashion, Food, Gaming, Education, Business, Travel, Comedy / Entertainment, Parenting / Family, Wellness, Other.
`platform`	`string`	Optional	Only creators with an account on this platform. One of `tiktok` `instagram`
`country`	`string`	Optional	Only creators with one of these countries (ISO codes), comma-separated: US, CA, GB, AU, NZ.
`reach`	`string`	Optional	Only creators with one of these reach bands, comma-separated: nano, micro, mid, macro.
`experience`	`string`	Optional	Only creators with one of these experience levels, comma-separated: proven, established, member.
`engagement`	`string`	Optional	Only creators with one of these engagement bands, comma-separated: high, typical, low.
`fit`	`string`	Optional	Only the campaign's strongest fits, or only the possible ones. One of `matched` `possible`
`after`	`string`	Optional	nextCursor from the page before, for the next page.

Errors

A refusal answers { "error": { "code", "message" } }. Branch on code; the message is for a person. Every error and its fix

Status	error.code	Meaning
400 Bad Request	`invalid_request`	The request was not the shape this capability takes, or its body was not JSON.
401 Unauthorized	`missing_token` `invalid_token` `token_revoked` `token_expired` `token_orphaned`	No token, or one that is not recognized, revoked or expired.
403 Forbidden	`insufficient_scope` `wrong_principal`	The token does not carry the scope this capability needs.
404 Not Found	`not_found`	No such route, or no such campaign for this client.
429 Too Many Requests	`rate_limited`	Too many requests this minute. Retry-After says how long is left.

const response = await fetch("https://api.tryscouty.com/v1/campaigns/42/club?niche=Beauty&reach=micro", { headers: { Authorization: `Bearer ${process.env.SCOUTY_TOKEN}`, }, }); console.log(await response.json());

import os import requests token = os.environ["SCOUTY_TOKEN"] response = requests.get( "https://api.tryscouty.com/v1/campaigns/42/club", headers={"Authorization": f"Bearer {token}"}, params={"niche": "Beauty", "reach": "micro"}, ) print(response.json())

{ "campaignId": 42, "creators": [ { "memberId": 7, "displayName": "Sample C.", "country": "US", "niches": [ "Beauty", "Lifestyle" ], "platforms": { "tiktok": true, "instagram": true }, "reach": "micro", "engagement": "high", "experience": "established", "fit": "matched", "invite": "none" } ], "nextCursor": null, "invitesLeft": 7 }