Developer platform · Public beta

Bring trusted reviews
to your own page.

Use RYCP profiles, approved reviews, reputation totals, search, and live badges in your website, portfolio, Discord tool, or application.

Make your first request →View endpoints
✓ No API key required✓ Approved public data only✓ JSON + SVG

01 · Quick start

One request. No setup.

The public API is read-only and does not require authentication. Use a Discord ID or custom RYCP slug as the identifier.

Base URLhttps://api.rycp.pro/v1
curl https://api.rycp.pro/v1/profiles/qfx
Pagination

Review responses include has_more and next_cursor. Send that cursor unchanged in your next request.

02 · Reference

Public API

Every endpoint below is implemented in API v1. Only information visible on an active public profile is returned.

GET/profiles/{identifier}

Get a public profile

Fetch a public RYCP profile and its reputation summary using a Discord ID or custom RYCP slug.

Parametersidentifier · Discord ID or custom slug · required

Example request
curl https://api.rycp.pro/v1/profiles/qfx
Example response
{
  "data": {
    "id": "123456789012345678",
    "display_name": "qfx",
    "type": "freelancer",
    "custom_slug": "qfx",
    "profile_url": "https://rycp.pro/qfx",
    "reputation": {
      "review_count": 24,
      "average_rating": 4.92,
      "verified_reviews": 21
    }
  }
}
GET/profiles/{identifier}/reviews

List approved reviews

Fetch approved reviews and imported legacy vouches displayed on a public RYCP profile.

Parametersidentifier · required · limit · 1–100, default 20 · cursor · optional · sort · recent or top

Example request
curl 'https://api.rycp.pro/v1/profiles/qfx/reviews?limit=20&sort=recent'
Example response
{
  "data": [{
    "id": "117",
    "rating": 5,
    "message": "Reliable and easy to work with.",
    "reviewer": { "display_name": "Alex" },
    "verification_level": "approved",
    "imported": false,
    "created_at": "2026-09-20 18:42:00"
  }],
  "pagination": { "limit": 20, "has_more": false, "next_cursor": null }
}
GET/profiles/{identifier}/badge.svg

Embed a live reputation badge

Return a lightweight SVG badge showing the current public rating and approved review count.

Parametersidentifier · Discord ID or custom slug · required

Example request
<img src="https://api.rycp.pro/v1/profiles/qfx/badge.svg" alt="RYCP reputation">
Example response
<svg xmlns="http://www.w3.org/2000/svg" width="208" height="32">
  <text>RYCP 4.9 · 24 reviews</text>
</svg>
GET/search

Search public profiles

Find active profiles by display name, username, Discord ID, custom slug, or headline.

Parametersq · at least 2 characters · type · all, freelancer, staff, or server · limit · 1–50

Example request
curl 'https://api.rycp.pro/v1/search?q=design&type=freelancer&limit=10'
Example response
{
  "query": "design",
  "data": [{
    "id": "123456789012345678",
    "display_name": "Alex",
    "type": "freelancer",
    "custom_slug": "alexdesign",
    "reputation": { "review_count": 12, "average_rating": 4.83 }
  }]
}
GET/health

Check API availability

Check whether API v1 and its database connection are available.

ParametersNo parameters

Example request
curl https://api.rycp.pro/v1/health
Example response
{ "status": "ok", "version": "v1", "timestamp": "2026-09-25T15:30:00.000Z" }

03 · Examples

Use it in your stack.

Standard HTTPS and JSON work with almost every language and hosting provider.

const response = await fetch(
  "https://api.rycp.pro/v1/profiles/qfx/reviews?limit=10"
);
if (!response.ok) throw new Error("RYCP request failed");
const { data: reviews } = await response.json();
reviews.forEach((review) => console.log(review.rating, review.message));

04 · Reliability

Errors and limits.

Errors include a stable code. Public requests are limited to 60 per minute per client. Current limits are returned in X-RateLimit-* headers.

400

Invalid parameter, cursor, or search query.

404

The requested public profile was not found.

429

The client exceeded 60 requests in one minute.

503

The API or database is temporarily unavailable.

05 · Data safety

Public means public—nothing more.

The API never returns pending or denied reviews, private profile sections, proof files, moderation notes, staff information, sessions, email addresses, or secrets. Existing profile visibility settings continue to apply.

06 · Changelog

API v1 public beta.

September 25, 2026v1 launch

Profile lookup, approved reviews, imported vouches, search, SVG badges, CORS, stable errors, and public rate limits.