🔍 GET /api/v1/search
Public endpoint to search sponsor codes.
Query Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Search term for code, sponsor, creator or ID |
| creator | string | No | Filter by creator |
| sponsor | string | No | Filter by sponsor brand |
| code | string | No | Filter by specific code |
| page | int | No | Pagination (default: 1) |
| limit | int | No | Results per page (default: 50) |
Example Request:
GET /api/v1/search?q=marques brownlee
Example Response:
{
"results": [
{
"id": "DT21",
"code": null,
"link": "https://ridge.com/MKBHD",
"deal": "Tick. Tock. Finally, some meaningful updates to the Samsung folding phones. Save Up To 49% Off at https://ridge.com/MKBHD or ...",
"date_added": "2025-07-17T23:00:00.000Z",
"report_count": 1,
"status": "cleared",
"sponsor_brand": null,
"creator": "Marques Brownlee",
"creator_avatar": "https://yt3.ggpht.com/PEwQfVuhh5jO7_NDDufCq349q0W6MgZeYlgeMyW3OSRMxMx9W5yre5Fgbi4Bql56L1cPwoteOA=s88-c-k-c0x00ffffff-no-rj",
"platform": "YouTube",
"video_url": "https://www.youtube.com/watch?v=bMou1qUMHC4"
}
],
"pagination": {
"page": 1,
"limit": 50,
"count": 1
}
}
📊 GET /api/v1/insights
Analytics endpoint for internal use. Still public tho...
Metrics Supported:
top-creators– List of top creators by countsubmissions-per-day– Daily submission by countapproval-rate– Status breakdown - total cleared/rejected and approval rate in 'percent'
Query Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| metric | string | Yes | The metric type (e.g. top-creators) |
| filter | string | No | Comma-separated filters (e.g. platform:YouTube) |
| page | int | No | Pagination (default: 1) |
| limit | int | No | Results per page (default: 10) |