Developer recipe

Find micro-influencers with a creator search API

Shortlist US skincare creators with 10,000–100,000 followers and a published contact email. This example defines the follower band explicitly so your product can use its own definition of micro-influencer.

Get your free API keyRead the docs
Job budget
10 credits
Request cap
1 search
Interface
REST · cURL

The workflow

  1. Turn the brief into filters

    Set niche, country and both follower bounds. Creator location describes the creator, not their audience. Omit has_email if an email is not required for your shortlist.

  2. Search once, inspect the returned records

    The search response already includes profile fields. Do not spend an additional profile-read credit merely to retrieve the same data. Use pagination.total to see how many records match, and request another page only if needed.

  3. Review fit before contacting anyone

    Save each candidate’s pk and username, then review their work and commercial fit. A follower band does not establish willingness to create UGC, pricing, availability or campaign performance.

Example request

cURL
curl --fail-with-body "https://api.ugcroster.com/v1/creators/search" \
  -H "Authorization: Bearer $ROSTER_API_KEY" \
  -G \
  --data-urlencode "niche=skincare" \
  --data-urlencode "country=US" \
  --data-urlencode "follower_min=10000" \
  --data-urlencode "follower_max=100000" \
  --data-urlencode "has_email=true" \
  --data-urlencode "sort=followers" \
  --data-urlencode "limit=100"

Set ROSTER_API_KEY in your environment. Keep the key on your server. This command requests one page.

Example request, not a live benchmark. A data key covers search and profile reads. Campaign writes require a Roster brand key.

Price the job before you build.

1 search requests × 10 credits + 0 profile reads × 1 credit = 10 credits.

Allocated workflow cost at full use of each plan’s monthly credits
PlanMonthly subscriptionAllocated job cost*
Starter$98$0.0392
Growth$398$0.0265
Scale$998$0.0200

Prepaid alternative: $0.0500 worth of credits for this request budget, purchased in packs starting at $25 for 5,000 credits. No monthly subscription; 60 requests/minute. Auto-reload is optional. This is credit consumption, not a per-call checkout.

*Monthly subscription price divided by included credits, multiplied by this job’s credits. These are illustrative allocations assuming full use of the allowance, not standalone pay-per-call checkout prices. You still pay the subscription. Extra purchased credits, tax and retries are excluded.

Calculate your monthly workload

Keep building