curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/influencers/11111111-1111-4111-8111-111111111111' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Influencer retrieved",
"data": {
"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"
}
}
Influencers
Get Influencer
Read one influencer (consistent character) and its reference images
GET
/
api
/
partner
/
v1
/
influencers
/
{influencerId}
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/influencers/11111111-1111-4111-8111-111111111111' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Influencer retrieved",
"data": {
"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"
}
}
Returns one influencer visible to the authenticated key scope.
Pass
reference_image_urls to Studio image generation as image_urls to
create new images of the same person.
Path Parameters
string
required
Influencer ID from List Influencers.
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/influencers/11111111-1111-4111-8111-111111111111' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Influencer retrieved",
"data": {
"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"
}
}
Error Responses
400-influencerIdis missing401- authentication failed404- influencer does not exist or is not visible in this scope422 invalid_path-influencerIdis not a UUID