curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/influencers?limit=20' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Influencers retrieved",
"data": {
"influencers": [
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "Maya",
"reference_image_urls": [
"https://cdn.example.com/maya.jpg"
],
"created_at": "2026-08-24T12:00:00.000Z",
"updated_at": "2026-08-24T12:00:00.000Z"
}
],
"limit": 20,
"has_more": false
}
}
Influencers
List Influencers
List influencers (consistent characters) and their reference images
GET
/
api
/
partner
/
v1
/
influencers
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/influencers?limit=20' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Influencers retrieved",
"data": {
"influencers": [
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "Maya",
"reference_image_urls": [
"https://cdn.example.com/maya.jpg"
],
"created_at": "2026-08-24T12:00:00.000Z",
"updated_at": "2026-08-24T12:00:00.000Z"
}
],
"limit": 20,
"has_more": false
}
}
Returns every influencer visible to the authenticated key scope.
An influencer is a consistent character: one or more reference images of a
person, reused to generate new images of that person. The response does not
distinguish how the character was created.
Query Parameters
number
default:"20"
Number of influencers to return. Range:
1-50.Response
array
number
boolean
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/influencers?limit=20' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Influencers retrieved",
"data": {
"influencers": [
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "Maya",
"reference_image_urls": [
"https://cdn.example.com/maya.jpg"
],
"created_at": "2026-08-24T12:00:00.000Z",
"updated_at": "2026-08-24T12:00:00.000Z"
}
],
"limit": 20,
"has_more": false
}
}
Error Responses
422 invalid_query- query params failed validation401- authentication failed