Creator email API

Creator contact emails, as a query parameter.

Add has_email=true to any creator search and every returned record carries an extracted_email field: contact data and audience data in the same response.

base: https://api.ugcroster.com/v1 · auth: Bearer rsk_…

Outbound to creators usually means two vendors: one to find the creators, one to find their emails. This API collapses that into one request. The directory extracts contact emails from creator profiles where they are available, stores them on the record as extracted_email, and exposes has_email as a search filter, so "skincare creators in California with 10k+ followers and a reachable inbox" is a single 10-credit call.

Authentication is one header (Authorization: Bearer rsk_...) against one base URL, https://api.ugcroster.com/v1. The first request works from a bare curl command; an SDK is never required.

find-reachable-creators.sh

LIVE
curl "https://api.ugcroster.com/v1/creators/search" \
  -H "Authorization: Bearer rsk_live_..." \
  -G \
  -d niche=skincare \
  -d state=CA \
  -d follower_min=10000 \
  -d has_email=true \
  -d sort=engagement \
  -d limit=100

Every record in this response has an extracted_email (the filter guarantees it) alongside followers, engagement and location for segmentation.

Why this shape

What you get out of the box.

01

Email is a search filter

has_email=true restricts the search itself, so you never pay to page through unreachable profiles. The email arrives on the same record as the other 15 fields.

02

Context for the first line

Each record ships niche, category, bio, follower count, engagement rate and city/state/country with the email, so your outreach tooling can personalise from the same API response it sourced from.

03

Priced for list-building

A 10-credit search returns up to 100 email-bearing records. On Starter ($49/mo, 25,000 credits) that is 2,500 searches (up to 250,000 records) before you touch a higher tier.

How it works

From filter to outreach list

1

Define the segment

Combine has_email=true with any of the other 13 filters: niche, category, follower band, engagement floor, city/state/country, gender, age range, free-text q.

2

Page through matches

Search returns up to 100 records per page with a pagination object. Walk pages within your tier’s rate limit (60/120/300 requests per minute) until the segment is exhausted.

3

Sync into your sequencer

Map extracted_email plus the profile fields straight into your CRM or outbound tool. Re-read any record later for 1 credit to refresh it before a send.

In depth

How the emails get there, and what we promise

The emails in the directory are extracted from what creators publish about themselves (the contact surfaces of their public profiles) and attached to the record as extracted_email. That has two consequences worth being direct about. First, these are addresses creators chose to make available for contact, which is the population you want for outreach anyway. Second, coverage can never be 100%: plenty of excellent creators simply do not publish an email.

That is why the filter exists. Rather than promising an email on every one of the 1,000,000+ records, the API lets you make reachability part of the query: has_email=true means every record you pay to receive is one you can actually contact. For workflows where reach matters less than fit, drop the filter and use the email as a bonus field when present.

For teams doing this at volume, the arithmetic is friendly. Searches cost 10 credits regardless of how many of the up-to-100 returned records carry emails, and profile reads cost 1 credit. Growth at $199/month funds 15,000 searches; even a conservative pipeline that re-reads every record before sending stays comfortably inside the tier. And because the API is the front door to a marketplace, the email is only the start: when cold outreach turns into a working relationship, a Roster brand plan lets you brief, contract, message and pay that creator on the same key.

Honesty note: emails are present where available, never guaranteed per record. Creators who do not publish contact details will not have an extracted_email, and no address is fabricated or "predicted". Use has_email=true when your workflow requires one.

FAQ

Straight answers.

Does every creator record include an email?

No, and any vendor claiming 100% coverage is padding. Emails appear on records where the creator has made one available; the has_email=true filter restricts search results to exactly those records.

Where do the email addresses come from?

They are extracted from creators’ own public contact surfaces and stored on the directory record as extracted_email. They are addresses creators chose to publish, never guessed or synthesised.

How do I search only creators with emails?

Add has_email=true to GET /v1/creators/search. It combines with all other filters: niche, follower_min/max, engagement_min, city/state/country, gender, age range and sort.

What does building an email list cost?

Each search is 10 credits and returns up to 100 records. Starter ($49/mo, 25,000 credits) covers 2,500 searches; Growth ($199/mo) covers 15,000; Scale ($499/mo) covers 50,000. Profile re-reads are 1 credit.

Can I verify or refresh an email later?

Re-read the creator with GET /v1/creators/{pk} for 1 credit to get the current record, including its email field. Deliverability verification is your sender’s job; the API gives you the published address and its context.

First request in under five minutes.

Self-serve keys, credit pricing, no sales call. The docs get you from zero to a filtered creator search in one curl command.