User Suggestions

Generate suggestions

curl --request POST \
  --url https://api.dumgum.com/cs/v1/content_creation/suggestion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userProfile": {
    "id": "<string>",
    "version": "2025-01-01T12:34:20Z",
    "firstName": "<string>",
    "nickname": "<string>",
    "description": "<string>",
    "birthdate": "1990-05-14",
    "countryCode": "FR",
    "city": "<string>",
    "postalCode": "<string>",
    "timeZone": "Europe/Paris",
    "features": {
      "height": 123,
      "weight": 123,
      "job": "<string>",
      "working": null,
      "interests": [],
      "bdsmInterests": [],
      "sexualInterests": [],
      "lookingFor": [],
      "childrenCount": 123,
      "unitSystem": "METRIC",
      "sports": [],
      "musicGenres": []
    },
    "mainPictureUrl": "https://example.org/images/public.jpg",
    "pictures": [
      "https://example.org/images/public.jpg"
    ],
    "privatePictures": [
      "https://example.org/images/private.jpg"
    ],
    "expiresAt": "2025-01-01T12:34:20Z",
    "children": [
      {
        "name": "<string>",
        "age": 123
      }
    ],
    "pets": [
      {
        "name": "<string>",
        "age": 123,
        "breed": "<string>",
        "type": "<string>"
      }
    ]
  },
  "personaProfile": {
    "id": "<string>",
    "version": "2025-01-01T12:34:20Z",
    "firstName": "<string>",
    "nickname": "<string>",
    "description": "<string>",
    "birthdate": "1990-05-14",
    "countryCode": "FR",
    "city": "<string>",
    "postalCode": "<string>",
    "timeZone": "Europe/Paris",
    "features": {
      "height": 123,
      "weight": 123,
      "job": "<string>",
      "working": null,
      "interests": [],
      "bdsmInterests": [],
      "sexualInterests": [],
      "lookingFor": [],
      "childrenCount": 123,
      "unitSystem": "METRIC",
      "sports": [],
      "musicGenres": []
    },
    "mainPictureUrl": "https://example.org/images/public.jpg",
    "pictures": [
      "https://example.org/images/public.jpg"
    ],
    "privatePictures": [
      "https://example.org/images/private.jpg"
    ],
    "expiresAt": "2025-01-01T12:34:20Z",
    "children": [
      {
        "name": "<string>",
        "age": 123
      }
    ],
    "pets": [
      {
        "name": "<string>",
        "age": 123,
        "breed": "<string>",
        "type": "<string>"
      }
    ]
  },
  "messages": [
    {
      "id": "<string>",
      "date": "2023-04-25T10:00:00Z",
      "pictureUrls": [
        "<string>"
      ],
      "videoUrls": [
        "<string>"
      ],
      "poke": true,
      "gifts": [
        {
          "name": "<string>"
        }
      ],
      "sticker": "<string>",
      "text": "<string>"
    }
  ]
}
'

import requests

url = "https://api.dumgum.com/cs/v1/content_creation/suggestion"

payload = {
    "userProfile": {
        "id": "<string>",
        "version": "2025-01-01T12:34:20Z",
        "firstName": "<string>",
        "nickname": "<string>",
        "description": "<string>",
        "birthdate": "1990-05-14",
        "countryCode": "FR",
        "city": "<string>",
        "postalCode": "<string>",
        "timeZone": "Europe/Paris",
        "features": {
            "height": 123,
            "weight": 123,
            "job": "<string>",
            "working": None,
            "interests": [],
            "bdsmInterests": [],
            "sexualInterests": [],
            "lookingFor": [],
            "childrenCount": 123,
            "unitSystem": "METRIC",
            "sports": [],
            "musicGenres": []
        },
        "mainPictureUrl": "https://example.org/images/public.jpg",
        "pictures": ["https://example.org/images/public.jpg"],
        "privatePictures": ["https://example.org/images/private.jpg"],
        "expiresAt": "2025-01-01T12:34:20Z",
        "children": [
            {
                "name": "<string>",
                "age": 123
            }
        ],
        "pets": [
            {
                "name": "<string>",
                "age": 123,
                "breed": "<string>",
                "type": "<string>"
            }
        ]
    },
    "personaProfile": {
        "id": "<string>",
        "version": "2025-01-01T12:34:20Z",
        "firstName": "<string>",
        "nickname": "<string>",
        "description": "<string>",
        "birthdate": "1990-05-14",
        "countryCode": "FR",
        "city": "<string>",
        "postalCode": "<string>",
        "timeZone": "Europe/Paris",
        "features": {
            "height": 123,
            "weight": 123,
            "job": "<string>",
            "working": None,
            "interests": [],
            "bdsmInterests": [],
            "sexualInterests": [],
            "lookingFor": [],
            "childrenCount": 123,
            "unitSystem": "METRIC",
            "sports": [],
            "musicGenres": []
        },
        "mainPictureUrl": "https://example.org/images/public.jpg",
        "pictures": ["https://example.org/images/public.jpg"],
        "privatePictures": ["https://example.org/images/private.jpg"],
        "expiresAt": "2025-01-01T12:34:20Z",
        "children": [
            {
                "name": "<string>",
                "age": 123
            }
        ],
        "pets": [
            {
                "name": "<string>",
                "age": 123,
                "breed": "<string>",
                "type": "<string>"
            }
        ]
    },
    "messages": [
        {
            "id": "<string>",
            "date": "2023-04-25T10:00:00Z",
            "pictureUrls": ["<string>"],
            "videoUrls": ["<string>"],
            "poke": True,
            "gifts": [{ "name": "<string>" }],
            "sticker": "<string>",
            "text": "<string>"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    userProfile: {
      id: '<string>',
      version: '2025-01-01T12:34:20Z',
      firstName: '<string>',
      nickname: '<string>',
      description: '<string>',
      birthdate: '1990-05-14',
      countryCode: 'FR',
      city: '<string>',
      postalCode: '<string>',
      timeZone: 'Europe/Paris',
      features: {
        height: 123,
        weight: 123,
        job: '<string>',
        working: null,
        interests: [],
        bdsmInterests: [],
        sexualInterests: [],
        lookingFor: [],
        childrenCount: 123,
        unitSystem: 'METRIC',
        sports: [],
        musicGenres: []
      },
      mainPictureUrl: 'https://example.org/images/public.jpg',
      pictures: ['https://example.org/images/public.jpg'],
      privatePictures: ['https://example.org/images/private.jpg'],
      expiresAt: '2025-01-01T12:34:20Z',
      children: [{name: '<string>', age: 123}],
      pets: [{name: '<string>', age: 123, breed: '<string>', type: '<string>'}]
    },
    personaProfile: {
      id: '<string>',
      version: '2025-01-01T12:34:20Z',
      firstName: '<string>',
      nickname: '<string>',
      description: '<string>',
      birthdate: '1990-05-14',
      countryCode: 'FR',
      city: '<string>',
      postalCode: '<string>',
      timeZone: 'Europe/Paris',
      features: {
        height: 123,
        weight: 123,
        job: '<string>',
        working: null,
        interests: [],
        bdsmInterests: [],
        sexualInterests: [],
        lookingFor: [],
        childrenCount: 123,
        unitSystem: 'METRIC',
        sports: [],
        musicGenres: []
      },
      mainPictureUrl: 'https://example.org/images/public.jpg',
      pictures: ['https://example.org/images/public.jpg'],
      privatePictures: ['https://example.org/images/private.jpg'],
      expiresAt: '2025-01-01T12:34:20Z',
      children: [{name: '<string>', age: 123}],
      pets: [{name: '<string>', age: 123, breed: '<string>', type: '<string>'}]
    },
    messages: [
      {
        id: '<string>',
        date: '2023-04-25T10:00:00Z',
        pictureUrls: ['<string>'],
        videoUrls: ['<string>'],
        poke: true,
        gifts: [{name: '<string>'}],
        sticker: '<string>',
        text: '<string>'
      }
    ]
  })
};

fetch('https://api.dumgum.com/cs/v1/content_creation/suggestion', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dumgum.com/cs/v1/content_creation/suggestion",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'userProfile' => [
        'id' => '<string>',
        'version' => '2025-01-01T12:34:20Z',
        'firstName' => '<string>',
        'nickname' => '<string>',
        'description' => '<string>',
        'birthdate' => '1990-05-14',
        'countryCode' => 'FR',
        'city' => '<string>',
        'postalCode' => '<string>',
        'timeZone' => 'Europe/Paris',
        'features' => [
                'height' => 123,
                'weight' => 123,
                'job' => '<string>',
                'working' => null,
                'interests' => [
                                
                ],
                'bdsmInterests' => [
                                
                ],
                'sexualInterests' => [
                                
                ],
                'lookingFor' => [
                                
                ],
                'childrenCount' => 123,
                'unitSystem' => 'METRIC',
                'sports' => [
                                
                ],
                'musicGenres' => [
                                
                ]
        ],
        'mainPictureUrl' => 'https://example.org/images/public.jpg',
        'pictures' => [
                'https://example.org/images/public.jpg'
        ],
        'privatePictures' => [
                'https://example.org/images/private.jpg'
        ],
        'expiresAt' => '2025-01-01T12:34:20Z',
        'children' => [
                [
                                'name' => '<string>',
                                'age' => 123
                ]
        ],
        'pets' => [
                [
                                'name' => '<string>',
                                'age' => 123,
                                'breed' => '<string>',
                                'type' => '<string>'
                ]
        ]
    ],
    'personaProfile' => [
        'id' => '<string>',
        'version' => '2025-01-01T12:34:20Z',
        'firstName' => '<string>',
        'nickname' => '<string>',
        'description' => '<string>',
        'birthdate' => '1990-05-14',
        'countryCode' => 'FR',
        'city' => '<string>',
        'postalCode' => '<string>',
        'timeZone' => 'Europe/Paris',
        'features' => [
                'height' => 123,
                'weight' => 123,
                'job' => '<string>',
                'working' => null,
                'interests' => [
                                
                ],
                'bdsmInterests' => [
                                
                ],
                'sexualInterests' => [
                                
                ],
                'lookingFor' => [
                                
                ],
                'childrenCount' => 123,
                'unitSystem' => 'METRIC',
                'sports' => [
                                
                ],
                'musicGenres' => [
                                
                ]
        ],
        'mainPictureUrl' => 'https://example.org/images/public.jpg',
        'pictures' => [
                'https://example.org/images/public.jpg'
        ],
        'privatePictures' => [
                'https://example.org/images/private.jpg'
        ],
        'expiresAt' => '2025-01-01T12:34:20Z',
        'children' => [
                [
                                'name' => '<string>',
                                'age' => 123
                ]
        ],
        'pets' => [
                [
                                'name' => '<string>',
                                'age' => 123,
                                'breed' => '<string>',
                                'type' => '<string>'
                ]
        ]
    ],
    'messages' => [
        [
                'id' => '<string>',
                'date' => '2023-04-25T10:00:00Z',
                'pictureUrls' => [
                                '<string>'
                ],
                'videoUrls' => [
                                '<string>'
                ],
                'poke' => true,
                'gifts' => [
                                [
                                                                'name' => '<string>'
                                ]
                ],
                'sticker' => '<string>',
                'text' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dumgum.com/cs/v1/content_creation/suggestion"

	payload := strings.NewReader("{\n  \"userProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"personaProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"messages\": [\n    {\n      \"id\": \"<string>\",\n      \"date\": \"2023-04-25T10:00:00Z\",\n      \"pictureUrls\": [\n        \"<string>\"\n      ],\n      \"videoUrls\": [\n        \"<string>\"\n      ],\n      \"poke\": true,\n      \"gifts\": [\n        {\n          \"name\": \"<string>\"\n        }\n      ],\n      \"sticker\": \"<string>\",\n      \"text\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dumgum.com/cs/v1/content_creation/suggestion")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"personaProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"messages\": [\n    {\n      \"id\": \"<string>\",\n      \"date\": \"2023-04-25T10:00:00Z\",\n      \"pictureUrls\": [\n        \"<string>\"\n      ],\n      \"videoUrls\": [\n        \"<string>\"\n      ],\n      \"poke\": true,\n      \"gifts\": [\n        {\n          \"name\": \"<string>\"\n        }\n      ],\n      \"sticker\": \"<string>\",\n      \"text\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dumgum.com/cs/v1/content_creation/suggestion")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"personaProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"messages\": [\n    {\n      \"id\": \"<string>\",\n      \"date\": \"2023-04-25T10:00:00Z\",\n      \"pictureUrls\": [\n        \"<string>\"\n      ],\n      \"videoUrls\": [\n        \"<string>\"\n      ],\n      \"poke\": true,\n      \"gifts\": [\n        {\n          \"name\": \"<string>\"\n        }\n      ],\n      \"sticker\": \"<string>\",\n      \"text\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "suggestions": [
    "Lorem ipsum dolor sit amet.",
    "Consectetur adipiscing elit.",
    "Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
  ]
}

POST

content_creation

suggestion

Generate suggestions

curl --request POST \
  --url https://api.dumgum.com/cs/v1/content_creation/suggestion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userProfile": {
    "id": "<string>",
    "version": "2025-01-01T12:34:20Z",
    "firstName": "<string>",
    "nickname": "<string>",
    "description": "<string>",
    "birthdate": "1990-05-14",
    "countryCode": "FR",
    "city": "<string>",
    "postalCode": "<string>",
    "timeZone": "Europe/Paris",
    "features": {
      "height": 123,
      "weight": 123,
      "job": "<string>",
      "working": null,
      "interests": [],
      "bdsmInterests": [],
      "sexualInterests": [],
      "lookingFor": [],
      "childrenCount": 123,
      "unitSystem": "METRIC",
      "sports": [],
      "musicGenres": []
    },
    "mainPictureUrl": "https://example.org/images/public.jpg",
    "pictures": [
      "https://example.org/images/public.jpg"
    ],
    "privatePictures": [
      "https://example.org/images/private.jpg"
    ],
    "expiresAt": "2025-01-01T12:34:20Z",
    "children": [
      {
        "name": "<string>",
        "age": 123
      }
    ],
    "pets": [
      {
        "name": "<string>",
        "age": 123,
        "breed": "<string>",
        "type": "<string>"
      }
    ]
  },
  "personaProfile": {
    "id": "<string>",
    "version": "2025-01-01T12:34:20Z",
    "firstName": "<string>",
    "nickname": "<string>",
    "description": "<string>",
    "birthdate": "1990-05-14",
    "countryCode": "FR",
    "city": "<string>",
    "postalCode": "<string>",
    "timeZone": "Europe/Paris",
    "features": {
      "height": 123,
      "weight": 123,
      "job": "<string>",
      "working": null,
      "interests": [],
      "bdsmInterests": [],
      "sexualInterests": [],
      "lookingFor": [],
      "childrenCount": 123,
      "unitSystem": "METRIC",
      "sports": [],
      "musicGenres": []
    },
    "mainPictureUrl": "https://example.org/images/public.jpg",
    "pictures": [
      "https://example.org/images/public.jpg"
    ],
    "privatePictures": [
      "https://example.org/images/private.jpg"
    ],
    "expiresAt": "2025-01-01T12:34:20Z",
    "children": [
      {
        "name": "<string>",
        "age": 123
      }
    ],
    "pets": [
      {
        "name": "<string>",
        "age": 123,
        "breed": "<string>",
        "type": "<string>"
      }
    ]
  },
  "messages": [
    {
      "id": "<string>",
      "date": "2023-04-25T10:00:00Z",
      "pictureUrls": [
        "<string>"
      ],
      "videoUrls": [
        "<string>"
      ],
      "poke": true,
      "gifts": [
        {
          "name": "<string>"
        }
      ],
      "sticker": "<string>",
      "text": "<string>"
    }
  ]
}
'

import requests

url = "https://api.dumgum.com/cs/v1/content_creation/suggestion"

payload = {
    "userProfile": {
        "id": "<string>",
        "version": "2025-01-01T12:34:20Z",
        "firstName": "<string>",
        "nickname": "<string>",
        "description": "<string>",
        "birthdate": "1990-05-14",
        "countryCode": "FR",
        "city": "<string>",
        "postalCode": "<string>",
        "timeZone": "Europe/Paris",
        "features": {
            "height": 123,
            "weight": 123,
            "job": "<string>",
            "working": None,
            "interests": [],
            "bdsmInterests": [],
            "sexualInterests": [],
            "lookingFor": [],
            "childrenCount": 123,
            "unitSystem": "METRIC",
            "sports": [],
            "musicGenres": []
        },
        "mainPictureUrl": "https://example.org/images/public.jpg",
        "pictures": ["https://example.org/images/public.jpg"],
        "privatePictures": ["https://example.org/images/private.jpg"],
        "expiresAt": "2025-01-01T12:34:20Z",
        "children": [
            {
                "name": "<string>",
                "age": 123
            }
        ],
        "pets": [
            {
                "name": "<string>",
                "age": 123,
                "breed": "<string>",
                "type": "<string>"
            }
        ]
    },
    "personaProfile": {
        "id": "<string>",
        "version": "2025-01-01T12:34:20Z",
        "firstName": "<string>",
        "nickname": "<string>",
        "description": "<string>",
        "birthdate": "1990-05-14",
        "countryCode": "FR",
        "city": "<string>",
        "postalCode": "<string>",
        "timeZone": "Europe/Paris",
        "features": {
            "height": 123,
            "weight": 123,
            "job": "<string>",
            "working": None,
            "interests": [],
            "bdsmInterests": [],
            "sexualInterests": [],
            "lookingFor": [],
            "childrenCount": 123,
            "unitSystem": "METRIC",
            "sports": [],
            "musicGenres": []
        },
        "mainPictureUrl": "https://example.org/images/public.jpg",
        "pictures": ["https://example.org/images/public.jpg"],
        "privatePictures": ["https://example.org/images/private.jpg"],
        "expiresAt": "2025-01-01T12:34:20Z",
        "children": [
            {
                "name": "<string>",
                "age": 123
            }
        ],
        "pets": [
            {
                "name": "<string>",
                "age": 123,
                "breed": "<string>",
                "type": "<string>"
            }
        ]
    },
    "messages": [
        {
            "id": "<string>",
            "date": "2023-04-25T10:00:00Z",
            "pictureUrls": ["<string>"],
            "videoUrls": ["<string>"],
            "poke": True,
            "gifts": [{ "name": "<string>" }],
            "sticker": "<string>",
            "text": "<string>"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    userProfile: {
      id: '<string>',
      version: '2025-01-01T12:34:20Z',
      firstName: '<string>',
      nickname: '<string>',
      description: '<string>',
      birthdate: '1990-05-14',
      countryCode: 'FR',
      city: '<string>',
      postalCode: '<string>',
      timeZone: 'Europe/Paris',
      features: {
        height: 123,
        weight: 123,
        job: '<string>',
        working: null,
        interests: [],
        bdsmInterests: [],
        sexualInterests: [],
        lookingFor: [],
        childrenCount: 123,
        unitSystem: 'METRIC',
        sports: [],
        musicGenres: []
      },
      mainPictureUrl: 'https://example.org/images/public.jpg',
      pictures: ['https://example.org/images/public.jpg'],
      privatePictures: ['https://example.org/images/private.jpg'],
      expiresAt: '2025-01-01T12:34:20Z',
      children: [{name: '<string>', age: 123}],
      pets: [{name: '<string>', age: 123, breed: '<string>', type: '<string>'}]
    },
    personaProfile: {
      id: '<string>',
      version: '2025-01-01T12:34:20Z',
      firstName: '<string>',
      nickname: '<string>',
      description: '<string>',
      birthdate: '1990-05-14',
      countryCode: 'FR',
      city: '<string>',
      postalCode: '<string>',
      timeZone: 'Europe/Paris',
      features: {
        height: 123,
        weight: 123,
        job: '<string>',
        working: null,
        interests: [],
        bdsmInterests: [],
        sexualInterests: [],
        lookingFor: [],
        childrenCount: 123,
        unitSystem: 'METRIC',
        sports: [],
        musicGenres: []
      },
      mainPictureUrl: 'https://example.org/images/public.jpg',
      pictures: ['https://example.org/images/public.jpg'],
      privatePictures: ['https://example.org/images/private.jpg'],
      expiresAt: '2025-01-01T12:34:20Z',
      children: [{name: '<string>', age: 123}],
      pets: [{name: '<string>', age: 123, breed: '<string>', type: '<string>'}]
    },
    messages: [
      {
        id: '<string>',
        date: '2023-04-25T10:00:00Z',
        pictureUrls: ['<string>'],
        videoUrls: ['<string>'],
        poke: true,
        gifts: [{name: '<string>'}],
        sticker: '<string>',
        text: '<string>'
      }
    ]
  })
};

fetch('https://api.dumgum.com/cs/v1/content_creation/suggestion', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dumgum.com/cs/v1/content_creation/suggestion",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'userProfile' => [
        'id' => '<string>',
        'version' => '2025-01-01T12:34:20Z',
        'firstName' => '<string>',
        'nickname' => '<string>',
        'description' => '<string>',
        'birthdate' => '1990-05-14',
        'countryCode' => 'FR',
        'city' => '<string>',
        'postalCode' => '<string>',
        'timeZone' => 'Europe/Paris',
        'features' => [
                'height' => 123,
                'weight' => 123,
                'job' => '<string>',
                'working' => null,
                'interests' => [
                                
                ],
                'bdsmInterests' => [
                                
                ],
                'sexualInterests' => [
                                
                ],
                'lookingFor' => [
                                
                ],
                'childrenCount' => 123,
                'unitSystem' => 'METRIC',
                'sports' => [
                                
                ],
                'musicGenres' => [
                                
                ]
        ],
        'mainPictureUrl' => 'https://example.org/images/public.jpg',
        'pictures' => [
                'https://example.org/images/public.jpg'
        ],
        'privatePictures' => [
                'https://example.org/images/private.jpg'
        ],
        'expiresAt' => '2025-01-01T12:34:20Z',
        'children' => [
                [
                                'name' => '<string>',
                                'age' => 123
                ]
        ],
        'pets' => [
                [
                                'name' => '<string>',
                                'age' => 123,
                                'breed' => '<string>',
                                'type' => '<string>'
                ]
        ]
    ],
    'personaProfile' => [
        'id' => '<string>',
        'version' => '2025-01-01T12:34:20Z',
        'firstName' => '<string>',
        'nickname' => '<string>',
        'description' => '<string>',
        'birthdate' => '1990-05-14',
        'countryCode' => 'FR',
        'city' => '<string>',
        'postalCode' => '<string>',
        'timeZone' => 'Europe/Paris',
        'features' => [
                'height' => 123,
                'weight' => 123,
                'job' => '<string>',
                'working' => null,
                'interests' => [
                                
                ],
                'bdsmInterests' => [
                                
                ],
                'sexualInterests' => [
                                
                ],
                'lookingFor' => [
                                
                ],
                'childrenCount' => 123,
                'unitSystem' => 'METRIC',
                'sports' => [
                                
                ],
                'musicGenres' => [
                                
                ]
        ],
        'mainPictureUrl' => 'https://example.org/images/public.jpg',
        'pictures' => [
                'https://example.org/images/public.jpg'
        ],
        'privatePictures' => [
                'https://example.org/images/private.jpg'
        ],
        'expiresAt' => '2025-01-01T12:34:20Z',
        'children' => [
                [
                                'name' => '<string>',
                                'age' => 123
                ]
        ],
        'pets' => [
                [
                                'name' => '<string>',
                                'age' => 123,
                                'breed' => '<string>',
                                'type' => '<string>'
                ]
        ]
    ],
    'messages' => [
        [
                'id' => '<string>',
                'date' => '2023-04-25T10:00:00Z',
                'pictureUrls' => [
                                '<string>'
                ],
                'videoUrls' => [
                                '<string>'
                ],
                'poke' => true,
                'gifts' => [
                                [
                                                                'name' => '<string>'
                                ]
                ],
                'sticker' => '<string>',
                'text' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dumgum.com/cs/v1/content_creation/suggestion"

	payload := strings.NewReader("{\n  \"userProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"personaProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"messages\": [\n    {\n      \"id\": \"<string>\",\n      \"date\": \"2023-04-25T10:00:00Z\",\n      \"pictureUrls\": [\n        \"<string>\"\n      ],\n      \"videoUrls\": [\n        \"<string>\"\n      ],\n      \"poke\": true,\n      \"gifts\": [\n        {\n          \"name\": \"<string>\"\n        }\n      ],\n      \"sticker\": \"<string>\",\n      \"text\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dumgum.com/cs/v1/content_creation/suggestion")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"personaProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"messages\": [\n    {\n      \"id\": \"<string>\",\n      \"date\": \"2023-04-25T10:00:00Z\",\n      \"pictureUrls\": [\n        \"<string>\"\n      ],\n      \"videoUrls\": [\n        \"<string>\"\n      ],\n      \"poke\": true,\n      \"gifts\": [\n        {\n          \"name\": \"<string>\"\n        }\n      ],\n      \"sticker\": \"<string>\",\n      \"text\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dumgum.com/cs/v1/content_creation/suggestion")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"personaProfile\": {\n    \"id\": \"<string>\",\n    \"version\": \"2025-01-01T12:34:20Z\",\n    \"firstName\": \"<string>\",\n    \"nickname\": \"<string>\",\n    \"description\": \"<string>\",\n    \"birthdate\": \"1990-05-14\",\n    \"countryCode\": \"FR\",\n    \"city\": \"<string>\",\n    \"postalCode\": \"<string>\",\n    \"timeZone\": \"Europe/Paris\",\n    \"features\": {\n      \"height\": 123,\n      \"weight\": 123,\n      \"job\": \"<string>\",\n      \"working\": null,\n      \"interests\": [],\n      \"bdsmInterests\": [],\n      \"sexualInterests\": [],\n      \"lookingFor\": [],\n      \"childrenCount\": 123,\n      \"unitSystem\": \"METRIC\",\n      \"sports\": [],\n      \"musicGenres\": []\n    },\n    \"mainPictureUrl\": \"https://example.org/images/public.jpg\",\n    \"pictures\": [\n      \"https://example.org/images/public.jpg\"\n    ],\n    \"privatePictures\": [\n      \"https://example.org/images/private.jpg\"\n    ],\n    \"expiresAt\": \"2025-01-01T12:34:20Z\",\n    \"children\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123\n      }\n    ],\n    \"pets\": [\n      {\n        \"name\": \"<string>\",\n        \"age\": 123,\n        \"breed\": \"<string>\",\n        \"type\": \"<string>\"\n      }\n    ]\n  },\n  \"messages\": [\n    {\n      \"id\": \"<string>\",\n      \"date\": \"2023-04-25T10:00:00Z\",\n      \"pictureUrls\": [\n        \"<string>\"\n      ],\n      \"videoUrls\": [\n        \"<string>\"\n      ],\n      \"poke\": true,\n      \"gifts\": [\n        {\n          \"name\": \"<string>\"\n        }\n      ],\n      \"sticker\": \"<string>\",\n      \"text\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "suggestions": [
    "Lorem ipsum dolor sit amet.",
    "Consectetur adipiscing elit.",
    "Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is an access key.

Example: Authorization: Bearer sk-proj-XXXXXXXXX

Body

application/json

userProfile

object

required

A user profile; this will represent the profile that will receive the generated suggestions.

Hide child attributes

userProfile.id

string

required

The profile's ID (must be the same as the profileId parameter passed to the endpoint).

userProfile.gender

enum<string>

required

Gender of the profile owner.

Available options:

WOMAN,

MAN,

TRANS_MAN,

TRANSMASCULINE,

TRANS_WOMAN,

TRANSFEMININE

userProfile.version

string

An arbitrary string compared against the one stored in our profile database; any mismatch will trigger a profile data refresh. For example, you can use the latest update date as the version number.

Example:

"2025-01-01T12:34:20Z"

userProfile.firstName

string

First name of the profile owner. You must provide either a first name or a nickname. At least one is required.

userProfile.nickname

string

Nickname of the profile owner. You must provide either a first name or a nickname. At least one is required.

userProfile.description

string

Description of the profile.

userProfile.birthdate

string<yyyy-MM-dd>

Birthdate of the profile owner, formatted as yyyy-MM-dd.

Example:

"1990-05-14"

userProfile.countryCode

string

Country code of the profile owner. Must be a two-letter ISO 3166-1 alpha-2 code.

Required string length: 2

Example:

"FR"

userProfile.city

string

City of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the city will be ignored.

Maximum string length: 64

userProfile.postalCode

string

Postal code of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the postal code will be ignored.

Maximum string length: 64

userProfile.timeZone

string

Time zone of the profile owner. See our supported time zones list.

Example:

"Europe/Paris"

userProfile.features

object

Features of the profile.

Hide child attributes

userProfile.features.ethnicity

enum<string>

The ethnicity of the profile. Default is null.

Available options:

ASIAN,

BLACK,

CAUCASIAN,

MIDDLE_EAST,

HISPANIC_LATINO,

INDIAN,

MEDITERRANEAN,

OTHER,

UNCERTAIN

userProfile.features.height

integer<int32>

Height in metric by default (cm). Set unitSystem to IMPERIAL for inches.

userProfile.features.weight

integer<int32>

Weight in metric by default (kg). Set unitSystem to IMPERIAL for pounds.

userProfile.features.eyesColor

enum<string>

The color of the eyes. Default is null.

Available options:

BLACK,

BLUE_GREY,

BLUE,

BROWN,

GREEN_BLUE,

GREEN,

GREY,

OTHER,

UNKNOWN

userProfile.features.hairColor

enum<string>

The color of the hair. Default is null.

Available options:

BLACK,

BLOND,

BROWN,

DARK_BLOND,

GREY,

RED,

WHITE,

OTHER,

UNKNOWN

userProfile.features.hairLength

enum<string>

The length of the hair. Default is null.

Available options:

AVERAGE,

BALD,

HALF_LONG,

LONG,

SHORT,

VERY_LONG,

VERY_SHORT

userProfile.features.maritalStatus

enum<string>

The marital status of the profile. Default is null.

Available options:

SINGLE,

SEPARATED,

IN_RELATIONSHIP,

MARRIED,

DIVORCED,

WIDOW

userProfile.features.job

string

The job of the profile. Default is null.

Maximum string length: 32

userProfile.features.working

boolean

Explicitly controls whether the profile is currently working. When set, this takes precedence over inferring the working status from the presence of the job attribute. Defaults to null, in which case the working status is determined by whether job is set.

userProfile.features.interests

enum<string>[]

The interests of the profile. Default is an empty array.

Available options:

TAILORING,

BOOK_READING,

TRAVELING,

COOKING,

GARDENING,

PHOTOGRAPHY,

PAINTING,

MUSIC,

MOVIES,

CYCLING,

HIKING,

FITNESS,

GAMING,

DANCING,

YOGA,

SOFTWARE_DEVELOPMENT,

DIY_PROJECTS,

WRITING,

LANGUAGES,

ASTRONOMY,

VOLUNTEERING,

FISHING,

BIRD_WATCHING,

SPORTS,

EDUCATION,

ECONOMY,

FOOD_DRINKING,

CULINARY,

TECHNOLOGY,

MEDICAL,

NATURE,

CULTURE,

ART

userProfile.features.bdsmInterests

enum<string>[]

The BDSM interests of the profile. Default is an empty array.

Available options:

BDSM_BLOOD_PLAY,

BDSM_BONDAGE,

BDSM_BREATH_PLAY,

BDSM_BUTTOCKS,

BDSM_DOMINATION,

BDSM_EDGE_PLAY,

BDSM_FIRE_PLAY,

BDSM_FISTING,

BDSM_FLOGGING,

BDSM_GOLDEN_SHOWER,

BDSM_HARD,

BDSM_KINKSTER,

BDSM_KNIFE_PLAY,

BDSM_MASOCHIST,

BDSM_NEEDLE_PLAY,

BDSM_ORGASM_DENIAL,

BDSM_PET_PLAY,

BDSM_QUEENING_FACESITTING,

BDSM_SADISM,

BDSM_SOFT,

BDSM_STRAP_ON_DILDO,

BDSM_SUBMISSION,

BDSM_SUSPENSION,

BDSM_ZENTAI

userProfile.features.sexualInterests

enum<string>[]

The sexual interests of the profile. Default is an empty array.

Available options:

ANAL,

VAGINAL,

ORAL_GIVING,

ORAL_RECEIVING,

KISSING,

CUDDLING,

DOMINANCE,

SUBMISSION,

BDSM,

ROLEPLAY,

PUBLIC_SEX,

GROUP_SEX,

SWINGING,

WATCHING,

BEING_WATCHED,

THREESOME,

FOREPLAY,

DIRTY_TALK,

SENSUAL_MASSAGE,

TOYS,

LIGHT_BONDAGE,

SPANKING,

CHOKING,

FEET,

EXHIBITIONISM,

VOYEURISM

userProfile.features.lookingFor

enum<string>[]

The profile looking for genders. Default is an empty array.

Available options:

MAN,

WOMAN

userProfile.features.sexualOrientation

enum<string>

The sexual orientation of the profile. Default is null.

Available options:

HETEROSEXUAL,

GAY,

LESBIAN,

BISEXUAL,

ASEXUAL,

DEMISEXUAL,

PANSEXUAL,

QUEER,

QUESTIONING,

AROMANTIC,

OMNISEXUAL,

OTHER

userProfile.features.childrenCount

integer<int32>

The number of children the profile has. Default is null.

userProfile.features.wantsChildren

enum<string>

The preference for having children. Default is null.

Available options:

YES,

NO,

MAYBE

userProfile.features.surgeryStatus

enum<string>

For Transgender profile only. The surgery status of the profile. Default is null.

Available options:

UNKNOWN,

PRE_OP,

POST_OP,

NON_OP,

PREFER_NOT_TO_SAY

userProfile.features.unitSystem

enum<string>

default:METRIC

The unit system used for the profile. Default is METRIC.

Available options:

IMPERIAL,

METRIC

userProfile.features.livingWith

enum<string>

Describes the user's current living situation. Default is null if unspecified.

Available options:

ALONE,

KIDS,

PARENTS,

ROOMMATE,

PARTNER,

PARTNER_AND_KIDS

userProfile.features.education

enum<string>

The education level of the profile. Default is null.

Available options:

NO_EDUCATION,

PRIMARY_EDUCATION,

HIGH_SCHOOL_DIPLOMA,

ASSOCIATES_DEGREE,

BACHELORS_DEGREE,

MASTERS_DEGREE,

DOCTORATE

userProfile.features.religion

enum<string>

The religion of the profile. Default is null.

Available options:

NO_RELIGION,

AGNOSTIC,

CHRISTIAN,

CATHOLIC,

PROTESTANT,

MUSLIM,

JEWISH,

HINDU,

BUDDHIST,

SPIRITUAL,

OTHER

userProfile.features.smoking

enum<string>

The smoking habits of the profile. Default is null.

Available options:

NEVER,

OCCASIONALLY,

REGULARLY,

TRYING_TO_QUIT,

VAPING

userProfile.features.bodyShape

enum<string>

The body shape of the profile. Default is null.

Available options:

SLIM,

ATHLETIC,

AVERAGE,

FEW_EXTRA_POUNDS,

CURVY,

FULL_PLUS_SIZE,

MUSCULAR

userProfile.features.sports

enum<string>[]

The sports practiced by the profile. Default is an empty array.

Available options:

SOCCER,

BASKETBALL,

TENNIS,

SWIMMING,

RUNNING,

CYCLING,

GYM_CROSSFIT,

YOGA,

MARTIAL_ARTS,

VOLLEYBALL,

GOLF,

SKIING_SNOWBOARDING,

RUGBY,

SURFING

userProfile.features.musicGenres

enum<string>[]

The music genres preferred by the profile. Default is an empty array.

Available options:

POP,

ROCK,

HIP_HOP_RAP,

RNB_SOUL,

ELECTRONIC_DANCE,

CLASSICAL,

JAZZ,

COUNTRY,

METAL,

INDIE_FOLK,

LATIN,

REGGAE,

TECHNO

userProfile.personality

enum<string>

Personality of the profile.

Available options:

SUPPORTIVE,

TEASING,

CONFIDENT,

GEEKY,

POETIC,

HIGH_ENERGY,

INTELLECTUAL,

ROMANTIC,

SARCASTIC,

POSSESSIVE,

NATURAL,

APPRECIATIVE,

PASSIONATE

userProfile.mainPictureUrl

string

URL of the main picture. Must be HTTPS

Example:

"https://example.org/images/public.jpg"

userProfile.pictures

string[]

List of public picture URLs. All URLs must be HTTPS

Example:

["https://example.org/images/public.jpg"]

userProfile.privatePictures

string[]

List of private picture URLs. All URLs must be HTTPS

Example:

["https://example.org/images/private.jpg"]

userProfile.expiresAt

string<date-time>

An ISO-8601 formatted date. By default, set to one week after profile creation. Purges profile data when reached; fresh data is fetched on next use. Avoid setting durations shorter than 24 hours. Use the version parameter for user profile updates.

Example:

"2025-01-01T12:34:20Z"

userProfile.children

object[]

List of children the profile has.

Hide child attributes

userProfile.children.name

string

Name of the child.

Required string length: 1 - 32

userProfile.children.gender

enum<string>

Gender of the child.

Available options:

WOMAN,

MAN,

TRANS_MAN,

TRANSMASCULINE,

TRANS_WOMAN,

TRANSFEMININE

userProfile.children.age

integer<int32>

Age of the child.

userProfile.pets

object[]

List of pets the profile has.

Hide child attributes

userProfile.pets.name

string

Name of the pet.

Required string length: 1 - 32

userProfile.pets.sex

enum<string>

Sex of the pet.

Available options:

MALE,

FEMALE

userProfile.pets.age

integer<int32>

Age of the pet.

userProfile.pets.breed

string

Breed of the pet.

Required string length: 1 - 32

userProfile.pets.type

string

Type of the pet.

Required string length: 1 - 32

personaProfile

object

required

A persona profile; this will represent the profile that supposed to receive the suggestions

Hide child attributes

personaProfile.id

string

required

The profile's ID (must be the same as the profileId parameter passed to the endpoint).

personaProfile.gender

enum<string>

required

Gender of the profile owner.

Available options:

WOMAN,

MAN,

TRANS_MAN,

TRANSMASCULINE,

TRANS_WOMAN,

TRANSFEMININE

personaProfile.version

string

An arbitrary string compared against the one stored in our profile database; any mismatch will trigger a profile data refresh. For example, you can use the latest update date as the version number.

Example:

"2025-01-01T12:34:20Z"

personaProfile.firstName

string

First name of the profile owner. You must provide either a first name or a nickname. At least one is required.

personaProfile.nickname

string

Nickname of the profile owner. You must provide either a first name or a nickname. At least one is required.

personaProfile.description

string

Description of the profile.

personaProfile.birthdate

string<yyyy-MM-dd>

Birthdate of the profile owner, formatted as yyyy-MM-dd.

Example:

"1990-05-14"

personaProfile.countryCode

string

Country code of the profile owner. Must be a two-letter ISO 3166-1 alpha-2 code.

Required string length: 2

Example:

"FR"

personaProfile.city

string

City of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the city will be ignored.

Maximum string length: 64

personaProfile.postalCode

string

Postal code of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the postal code will be ignored.

Maximum string length: 64

personaProfile.timeZone

string

Time zone of the profile owner. See our supported time zones list.

Example:

"Europe/Paris"

personaProfile.features

object

Features of the profile.

Hide child attributes

personaProfile.features.ethnicity

enum<string>

The ethnicity of the profile. Default is null.

Available options:

ASIAN,

BLACK,

CAUCASIAN,

MIDDLE_EAST,

HISPANIC_LATINO,

INDIAN,

MEDITERRANEAN,

OTHER,

UNCERTAIN

personaProfile.features.height

integer<int32>

Height in metric by default (cm). Set unitSystem to IMPERIAL for inches.

personaProfile.features.weight

integer<int32>

Weight in metric by default (kg). Set unitSystem to IMPERIAL for pounds.

personaProfile.features.eyesColor

enum<string>

The color of the eyes. Default is null.

Available options:

BLACK,

BLUE_GREY,

BLUE,

BROWN,

GREEN_BLUE,

GREEN,

GREY,

OTHER,

UNKNOWN

personaProfile.features.hairColor

enum<string>

The color of the hair. Default is null.

Available options:

BLACK,

BLOND,

BROWN,

DARK_BLOND,

GREY,

RED,

WHITE,

OTHER,

UNKNOWN

personaProfile.features.hairLength

enum<string>

The length of the hair. Default is null.

Available options:

AVERAGE,

BALD,

HALF_LONG,

LONG,

SHORT,

VERY_LONG,

VERY_SHORT

personaProfile.features.maritalStatus

enum<string>

The marital status of the profile. Default is null.

Available options:

SINGLE,

SEPARATED,

IN_RELATIONSHIP,

MARRIED,

DIVORCED,

WIDOW

personaProfile.features.job

string

The job of the profile. Default is null.

Maximum string length: 32

personaProfile.features.working

boolean

personaProfile.features.interests

enum<string>[]

The interests of the profile. Default is an empty array.

Available options:

TAILORING,

BOOK_READING,

TRAVELING,

COOKING,

GARDENING,

PHOTOGRAPHY,

PAINTING,

MUSIC,

MOVIES,

CYCLING,

HIKING,

FITNESS,

GAMING,

DANCING,

YOGA,

SOFTWARE_DEVELOPMENT,

DIY_PROJECTS,

WRITING,

LANGUAGES,

ASTRONOMY,

VOLUNTEERING,

FISHING,

BIRD_WATCHING,

SPORTS,

EDUCATION,

ECONOMY,

FOOD_DRINKING,

CULINARY,

TECHNOLOGY,

MEDICAL,

NATURE,

CULTURE,

ART

personaProfile.features.bdsmInterests

enum<string>[]

The BDSM interests of the profile. Default is an empty array.

Available options:

BDSM_BLOOD_PLAY,

BDSM_BONDAGE,

BDSM_BREATH_PLAY,

BDSM_BUTTOCKS,

BDSM_DOMINATION,

BDSM_EDGE_PLAY,

BDSM_FIRE_PLAY,

BDSM_FISTING,

BDSM_FLOGGING,

BDSM_GOLDEN_SHOWER,

BDSM_HARD,

BDSM_KINKSTER,

BDSM_KNIFE_PLAY,

BDSM_MASOCHIST,

BDSM_NEEDLE_PLAY,

BDSM_ORGASM_DENIAL,

BDSM_PET_PLAY,

BDSM_QUEENING_FACESITTING,

BDSM_SADISM,

BDSM_SOFT,

BDSM_STRAP_ON_DILDO,

BDSM_SUBMISSION,

BDSM_SUSPENSION,

BDSM_ZENTAI

personaProfile.features.sexualInterests

enum<string>[]

The sexual interests of the profile. Default is an empty array.

Available options:

ANAL,

VAGINAL,

ORAL_GIVING,

ORAL_RECEIVING,

KISSING,

CUDDLING,

DOMINANCE,

SUBMISSION,

BDSM,

ROLEPLAY,

PUBLIC_SEX,

GROUP_SEX,

SWINGING,

WATCHING,

BEING_WATCHED,

THREESOME,

FOREPLAY,

DIRTY_TALK,

SENSUAL_MASSAGE,

TOYS,

LIGHT_BONDAGE,

SPANKING,

CHOKING,

FEET,

EXHIBITIONISM,

VOYEURISM

personaProfile.features.lookingFor

enum<string>[]

The profile looking for genders. Default is an empty array.

Available options:

MAN,

WOMAN

personaProfile.features.sexualOrientation

enum<string>

The sexual orientation of the profile. Default is null.

Available options:

HETEROSEXUAL,

GAY,

LESBIAN,

BISEXUAL,

ASEXUAL,

DEMISEXUAL,

PANSEXUAL,

QUEER,

QUESTIONING,

AROMANTIC,

OMNISEXUAL,

OTHER

personaProfile.features.childrenCount

integer<int32>

The number of children the profile has. Default is null.

personaProfile.features.wantsChildren

enum<string>

The preference for having children. Default is null.

Available options:

YES,

NO,

MAYBE

personaProfile.features.surgeryStatus

enum<string>

For Transgender profile only. The surgery status of the profile. Default is null.

Available options:

UNKNOWN,

PRE_OP,

POST_OP,

NON_OP,

PREFER_NOT_TO_SAY

personaProfile.features.unitSystem

enum<string>

default:METRIC

The unit system used for the profile. Default is METRIC.

Available options:

IMPERIAL,

METRIC

personaProfile.features.livingWith

enum<string>

Describes the user's current living situation. Default is null if unspecified.

Available options:

ALONE,

KIDS,

PARENTS,

ROOMMATE,

PARTNER,

PARTNER_AND_KIDS

personaProfile.features.education

enum<string>

The education level of the profile. Default is null.

Available options:

NO_EDUCATION,

PRIMARY_EDUCATION,

HIGH_SCHOOL_DIPLOMA,

ASSOCIATES_DEGREE,

BACHELORS_DEGREE,

MASTERS_DEGREE,

DOCTORATE

personaProfile.features.religion

enum<string>

The religion of the profile. Default is null.

Available options:

NO_RELIGION,

AGNOSTIC,

CHRISTIAN,

CATHOLIC,

PROTESTANT,

MUSLIM,

JEWISH,

HINDU,

BUDDHIST,

SPIRITUAL,

OTHER

personaProfile.features.smoking

enum<string>

The smoking habits of the profile. Default is null.

Available options:

NEVER,

OCCASIONALLY,

REGULARLY,

TRYING_TO_QUIT,

VAPING

personaProfile.features.bodyShape

enum<string>

The body shape of the profile. Default is null.

Available options:

SLIM,

ATHLETIC,

AVERAGE,

FEW_EXTRA_POUNDS,

CURVY,

FULL_PLUS_SIZE,

MUSCULAR

personaProfile.features.sports

enum<string>[]

The sports practiced by the profile. Default is an empty array.

Available options:

SOCCER,

BASKETBALL,

TENNIS,

SWIMMING,

RUNNING,

CYCLING,

GYM_CROSSFIT,

YOGA,

MARTIAL_ARTS,

VOLLEYBALL,

GOLF,

SKIING_SNOWBOARDING,

RUGBY,

SURFING

personaProfile.features.musicGenres

enum<string>[]

The music genres preferred by the profile. Default is an empty array.

Available options:

POP,

ROCK,

HIP_HOP_RAP,

RNB_SOUL,

ELECTRONIC_DANCE,

CLASSICAL,

JAZZ,

COUNTRY,

METAL,

INDIE_FOLK,

LATIN,

REGGAE,

TECHNO

personaProfile.personality

enum<string>

Personality of the profile.

Available options:

SUPPORTIVE,

TEASING,

CONFIDENT,

GEEKY,

POETIC,

HIGH_ENERGY,

INTELLECTUAL,

ROMANTIC,

SARCASTIC,

POSSESSIVE,

NATURAL,

APPRECIATIVE,

PASSIONATE

personaProfile.mainPictureUrl

string

URL of the main picture. Must be HTTPS

Example:

"https://example.org/images/public.jpg"

personaProfile.pictures

string[]

List of public picture URLs. All URLs must be HTTPS

Example:

["https://example.org/images/public.jpg"]

personaProfile.privatePictures

string[]

List of private picture URLs. All URLs must be HTTPS

Example:

["https://example.org/images/private.jpg"]

personaProfile.expiresAt

string<date-time>

Example:

"2025-01-01T12:34:20Z"

personaProfile.children

object[]

List of children the profile has.

Hide child attributes

personaProfile.children.name

string

Name of the child.

Required string length: 1 - 32

personaProfile.children.gender

enum<string>

Gender of the child.

Available options:

WOMAN,

MAN,

TRANS_MAN,

TRANSMASCULINE,

TRANS_WOMAN,

TRANSFEMININE

personaProfile.children.age

integer<int32>

Age of the child.

personaProfile.pets

object[]

List of pets the profile has.

Hide child attributes

personaProfile.pets.name

string

Name of the pet.

Required string length: 1 - 32

personaProfile.pets.sex

enum<string>

Sex of the pet.

Available options:

MALE,

FEMALE

personaProfile.pets.age

integer<int32>

Age of the pet.

personaProfile.pets.breed

string

Breed of the pet.

Required string length: 1 - 32

personaProfile.pets.type

string

Type of the pet.

Required string length: 1 - 32

language

enum<string>

required

The language used to generate the suggestions.

Available options:

EN,

EN_GB,

FR,

FR_BE,

RO,

NL,

ES,

DE,

DE_CH,

DE_AT,

IT,

ES_LATAM,

BG,

HE,

JA,

NL_BE,

EN_AU,

PT_PT,

PT_BR,

SV_SE,

DA_DK,

FI_FI,

PL_PL,

LT_LT,

NB_NO,

NN_NO,

SL_SI,

HU,

HU_HU,

CS_CZ,

EL_GR,

EL_GR_LATIN,

EL_GR_GREEK,

HR_HR,

TR_TR,

EN_IE,

AF_ZA,

ZU_ZA,

LV_LV,

SK_SK,

GA_IE,

SR_RS,

ET_EE,

EN_CA,

FR_CA,

RU_RU,

UA_UA

messages

object[]

required

A list of message describing the history of the conversation

Hide child attributes

messages.id

string

required

The unique identifier of the message. This is used by our system to deduplicate messages.

messages.sender

enum<string>

required

The sender of the message. Possible values are USER and PERSONA.

USER represents a user message ;
PERSONA represents a message sent by a persona (the profile for which we are going to generate content).

Available options:

USER,

PERSONA

messages.date

string<date-time>

required

Message timestamp in ISO-8601 format.

Example:

"2023-04-25T10:00:00Z"

messages.pictureUrls

string[]

The URL of the image associated with the message. This will be analyzed if the vision is enabled for the current request.

Pattern: ^https?://.*

messages.videoUrls

string[]

The URLs of the videos associated with the message. These will be analyzed if the vision is enabled for the current request.

Pattern: ^https?://.*

messages.poke

boolean

Flag the message as a poke, our chat models will react to it.

messages.gifts

object[]

Flag the message as a gift, our chat models will react to it.

Hide child attributes

messages.gifts.name

string

required

The name of the gift.

Examples:

"Champagne & Roses"

"Teddy Bear"

messages.gifts.tier

enum<string>

required

The value of the gift.

Available options:

LOW,

MEDIUM,

HIGH,

VERY_HIGH

messages.sticker

string

A text description of a sticker sent alongside the message. Our chat models will react to it naturally.

Maximum string length: 160

messages.text

string

Message's text content, can be null if the message does not contains text.

Maximum string length: 512

Response

200 - */*

Represents a list of suggestions generated by our platform.

suggestions

string[]

required

An array of 3 suggestions as text.

Example:

[
  "Lorem ipsum dolor sit amet.",
  "Consectetur adipiscing elit.",
  "Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
]