postman-collection-generator

Postman Collection Generator

Generates a valid, import-ready Postman Collection v2.1 JSON from:

• Natural language API descriptions
• cURL commands (one or many)
• Mixed input (some endpoints described, some as cURL)

---

Step 1 — Extract API Information

Parse the user's input and extract for each endpoint:

Field	Source
Name	Described name or inferred from path
Method	Explicit or inferred (GET for fetches, POST for creates, etc.)
URL	Full URL or path; use {{base_url}} variable for the host
Headers	From cURL -H flags or described headers
Auth	Bearer token, Basic, API Key, or None
Body	From cURL -d / --data or described payload (JSON, form-data)
Query params	From URL ?key=value or described filters

If input is ambiguous, make reasonable REST conventions and note assumptions at the end.

---

Step 2 — Build the Collection JSON

Use this exact v2.1 structure:

{
  "info": {
    "name": "<Collection Name>",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "<generate a UUID v4>",
    "description": "<brief description>"
  },
  "variable": [
    { "key": "base_url", "value": "<extracted base URL or placeholder>", "type": "string" }
  ],
  "auth": <collection-level auth if shared across requests, else null>,
  "item": [ <request items or folders> ]
}

Request item structure:

{
  "name": "Get Users",
  "request": {
    "method": "GET",
    "header": [
      { "key": "Content-Type", "value": "application/json" }
    ],
    "url": {
      "raw": "{{base_url}}/users",
      "host": ["{{base_url}}"],
      "path": ["users"],
      "query": []
    },
    "body": null,
    "auth": null,
    "description": ""
  },
  "response": []
}

Body (when present):

"body": {
  "mode": "raw",
  "raw": "{\n  \"key\": \"value\"\n}",
  "options": { "raw": { "language": "json" } }
}

Grouping:

• Group related endpoints into folders using the item array nested inside an item with "name" but no "request" key.
• Use logical grouping: by resource (Users, Orders) or by feature.