JSON to Protobuf Schema Generator

What is JSON to Protobuf Schema Generator?

Protocol Buffers (Protobuf) is Google's language-neutral binary serialization format that produces payloads 3 to 10 times smaller than JSON and parses 5 to 10 times faster. It is the standard wire format for gRPC APIs, event-driven microservices, and high-throughput data pipelines. This tool generates proto3 schema definitions from your JSON data by inspecting each value and mapping it to the appropriate Protobuf field type. Nested JSON objects become separate message definitions, arrays become repeated fields, and camelCase keys are automatically converted to snake_case following the Protobuf style guide. Integer values that exceed the int32 range are promoted to int64, and all floating-point values use the double type for maximum precision. The output is valid proto3 syntax ready to compile with protoc or buf.

How to Use

1. Set the package name (e.g., com.example.api) and root message name in the options above
2. Paste your JSON data into the input area — use a representative sample with realistic values
3. Click "Generate Proto" to create the proto3 schema
4. Review the generated messages and adjust field types if needed (e.g., change int32 to int64 for IDs)
5. Save the output as a .proto file and compile with protoc or buf to generate code in your target language

Tips & Best Practices

• Use realistic sample data — the type inference depends on actual values, not just structure
• Integer values that exceed int32 range (-2,147,483,648 to 2,147,483,647) are automatically typed as int64
• Empty arrays cannot infer element types and default to repeated string — update these manually
• Field names are automatically converted from camelCase to snake_case per Protobuf conventions
• Consider adding field descriptions as comments in the generated .proto file for documentation

Frequently Asked Questions

Real-world Examples

{
  "userId": 1,
  "name": "Alice Johnson",
  "isActive": true,
  "tags": ["developer", "admin"],
  "address": {
    "street": "123 Main St",
    "city": "Springfield"
  }
}

syntax = "proto3";

package example;

message Address {
  string street = 1;
  string city = 2;
}

message Message {
  int32 user_id = 1;
  string name = 2;
  bool is_active = 3;
  repeated string tags = 4;
  Address address = 5;
}

{
  "eventId": "evt-12345",
  "timestamp": "2024-01-15T10:30:00Z",
  "eventType": "order.created",
  "payload": {
    "orderId": 998877,
    "total": 149.99,
    "items": 3
  }
}

syntax = "proto3";

package example;

message Payload {
  int32 order_id = 1;
  double total = 2;
  int32 items = 3;
}

message Message {
  string event_id = 1;
  string timestamp = 2;
  string event_type = 3;
  Payload payload = 4;
}

Related Tools