Everything you need to integrate SocioLogic into your application
https://sociologic.ai/api/v1X-API-Key header (recommended)
X-API-Key: pl_live_your_key_here/personasList all available personas with filtering and pagination
Query Parameters
category - Filter by category
fidelity_tier - Filter by tier (standard, enhanced, premium, ultra)
min_fidelity_score - Minimum fidelity score (0-1)
tags - Comma-separated list of tags
search - Search in name, tagline, description
page - Page number (default: 1)
per_page - Results per page (1-100, default: 20)
Credits: 1 per request (list queries)
Example Request
curl -X GET "https://sociologic.ai/api/v1/personas?fidelity_tier=premium" \ -H "X-API-Key: pl_live_your_key_here"
/personas/:slugGet detailed information about a specific persona
Path Parameters
slug - The persona's unique identifier (e.g., "urban-millennial-tech")
Credits: 5 per persona (high-fidelity)
Example Request
curl -X GET "https://sociologic.ai/api/v1/personas/urban-millennial-tech" \ -H "X-API-Key: pl_live_your_key_here"
Enhance persona realism with semantic memory retrieval
/personas/:slug/interviewHave a conversation with a persona
Request Body
{
"message": "What do you look for when buying a new laptop?",
"conversation_id": "optional-uuid-to-continue-conversation",
"conversation_history": [
{ "role": "user", "content": "Previous message" },
{ "role": "assistant", "content": "Previous response" }
],
"stream": false,
"include_memory": true
}Credits: 1 per message (interview query)
Example Request
curl -X POST "https://sociologic.ai/api/v1/personas/urban-millennial-tech/interview" \
-H "X-API-Key: pl_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"message": "What motivates your purchasing decisions?"}'Bad Request
Invalid request parameters or body
Unauthorized
Missing or invalid API key
Payment Required
Insufficient credits
Not Found
Persona not found
Too Many Requests
Rate limit exceeded
Internal Server Error
Something went wrong
Rate limits are applied per API key based on your subscription tier:
| Tier | Per Minute | Per Day |
|---|---|---|
| Standard | 60 | 1,000 |
| Pro | 300 | 10,000 |
| Enterprise | 1,000 | 100,000 |
Create an account and get 100 free credits to try the API
Need help with the API? Contact our team