One endpoint. Any data.
Generate synthetic datasets programmatically. Supports natural language queries and structured parameters. Works with any HTTP client, agent framework, or language.
No key required.
The demo endpoint works immediately — no signup, no key. Max 5 records per call.
Request
POST /api/demo
{
"query": "5 patient records
for diabetes study"
}
curl
curl -s -X POST \
https://synthpipe.com/api/demo \
-H "Content-Type: application/json" \
-d '{"query":"5 patient records"}'
Full access with an API key.
Pass your key in the X-API-Key header. Free accounts get 500 records/month.
POST
/api/generate
Natural language
{
"query": "10 e-commerce orders
with products and shipping"
}
Structured
{
"category": "medical",
"size": 50
}
# Python
import requests
r = requests.post("https://synthpipe.com/api/generate",
headers={"X-API-Key": "YOUR_KEY"},
json={"query": "50 employee records for an engineering team"}
)
data = r.json()["data"]
Consistent JSON structure.
{
"success": true,
"data": [ /* array of records */ ],
"metadata": {
"size": 10,
"category": "medical",
"query": "10 patient records",
"generated_at": "2026-05-04T12:00:00Z",
"remaining_limit": 490
}
}
20+ domains available.
Pass these as the category field, or just describe what you need in plain language.
medical
finance
employee
resume
ecommerce
student
contact
logistics
legal
cybersecurity
ai
gaming
real_estate
restaurant
travel
social_media
vehicle
startup
insurance
manufacturing
sports
nonprofit
Standard error codes.
MISSING_QUERY
query or category is required
400
SIZE_LIMIT_EXCEEDED
max 1,000 records per request
400
QUOTA_EXCEEDED
monthly limit reached — upgrade to continue
402
GENERATION_FAILED
internal generation error
500
Built for AI agents.
SynthPipe is discoverable by MCP-compatible AI assistants and autonomous agents via standard well-known endpoints.
# Agent-discoverable endpoints
GET /.well-known/api-catalog # RFC 8288 catalog
GET /.well-known/mcp/server-card.json # MCP server card
GET /.well-known/agent-skills/index.json # ACP skills
POST /acp/v1/register # Agent registration