Query String Builder

Overview

You send a map of parameters and we return a percent-encoded query string ready to append to a URL. You choose how arrays and nested objects serialize — repeat keys, bracket notation, comma lists, and more — so the output matches what your API or signature scheme expects. Encoding follows RFC 3986 with uppercase hex; reserved characters are encoded unless you opt into form-style plus signs for spaces. We don't execute requests, parse URLs, or guess a server's conventions for you.

Generic URL encoders break signature schemes and APIs disagree on how arrays serialize. You need explicit, reproducible encoding rules.

When to use it

Scope

Non-goals

• Does not execute HTTP requests
• Does not parse or decode query strings
• Does not build paths or URL fragments
• Does not inject credentials — put tokens in headers
• Does not guess a server's array convention

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"network.build_query_string","input":{"parameters":{"q":"hello world"}}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("network.build_query_string", {"parameters":{"page":2,"filter":{"min":1,"max":10},"q":"hello world","tags":["a","b"]},"options":{"encodeSpaceAsPlus":false,"nullPolicy":"omit","arrayStyle":"repeat","objectStyle":"bracket","sortKeys":true}});

Errors

Other limits

Limitations

• Does not execute HTTP requests
• Does not parse or decode query strings
• Does not build paths or URL fragments
• Does not inject credentials — put tokens in headers
• Does not guess a server's array convention
• Sending the HTTP request itself
• Decoding an inbound query string
• Putting API keys in the query when the provider expects headers

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "network.build_query_string",
  "input": {
    "parameters": {
      "page": 2,
      "filter": {
        "min": 1,
        "max": 10
      },
      "q": "hello world",
      "tags": [
        "a",
        "b"
      ]
    },
    "options": {
      "encodeSpaceAsPlus": false,
      "nullPolicy": "omit",
      "arrayStyle": "repeat",
      "objectStyle": "bracket",
      "sortKeys": true
    }
  }
}

Examples

{
  "parameters": {
    "page": 2,
    "filter": {
      "min": 1,
      "max": 10
    },
    "q": "hello world",
    "tags": [
      "a",
      "b"
    ]
  },
  "options": {
    "encodeSpaceAsPlus": false,
    "nullPolicy": "omit",
    "arrayStyle": "repeat",
    "objectStyle": "bracket",
    "sortKeys": true
  }
}

{
  "parameterCount": 6,
  "options": {
    "encodeSpaceAsPlus": false,
    "nullPolicy": "omit",
    "arrayStyle": "repeat",
    "objectStyle": "bracket",
    "sortKeys": true
  },
  "encodedLength": 73,
  "findings": [],
  "_meta": {
    "flattenedKeyCount": 6,
    "reservedCharactersEncoded": 5
  },
  "queryString": "filter%5Bmax%5D=10&filter%5Bmin%5D=1&page=2&q=hello%20world&tags=a&tags=b"
}

{
  "parameters": {
    "q": "search",
    "tags": [
      "red",
      "blue"
    ]
  },
  "options": {
    "arrayStyle": "comma",
    "nullPolicy": "omit",
    "objectStyle": "bracket",
    "sortKeys": true
  }
}

{
  "parameterCount": 2,
  "options": {
    "encodeSpaceAsPlus": false,
    "nullPolicy": "omit",
    "arrayStyle": "comma",
    "objectStyle": "bracket",
    "sortKeys": true
  },
  "encodedLength": 24,
  "findings": [],
  "_meta": {
    "flattenedKeyCount": 2,
    "reservedCharactersEncoded": 1
  },
  "queryString": "q=search&tags=red%2Cblue"
}

Recommended use cases

• Construct signed URL query strings with stable, repeatable encoding
• Serialize nested filters for APIs that expect bracket or repeat array styles

Avoid for

• Sending the HTTP request itself
• Decoding an inbound query string
• Putting API keys in the query when the provider expects headers

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags