---
id: query-string
version: "2020.12.3"
license: Unlicense
license_treatment: permissive
maintenance: abandoned
---

# query-string — get url query string dict

License: permissive · Maintenance: abandoned · Downloads: 90.6K/mo

## What it is and what it does

query-string is a lightweight utility that extracts query parameters from URLs or raw query strings and returns them as a Python dictionary. It accepts either a full URL (from which it strips the query fragment) or a raw query string segment, parsing key-value pairs into a simple dict.

The package has no runtime dependencies and is permissively licensed under the Unlicense. However, it has been abandoned since December 2020 with no commits or releases since then. Python version support is unspecified, and the codebase has not been tested against modern Python versions or updated for any compatibility issues that may have emerged.

Use it for:

- Quick extraction of query parameters from a URL string when working with legacy code or a minimal dependency footprint.
- Parsing raw query string segments in simple scripts where urllib.parse feels like overkill.
- Educational or prototyping work where a straightforward query parser is needed without external complexity.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses URL query strings and fragments into Python dictionaries, extracting key-value pairs from both full URLs and raw query string segments.

No. The package is abandoned (last release 2020-12-03, no maintenance since), has unspecified Python support, and offers no advantage over Python's built-in urllib.parse module, which is actively maintained and part of the standard library. Use urllib.parse.parse_qs or urllib.parse.urlparse instead.

## Install

pip install query-string
uv add query-string
poetry add query-string

## Installing query-string

Before you install: High install friction due to abandonment: last release was 2020-12-03, no commits since then, and the repository shows no active maintenance. The package has no runtime dependencies, which simplifies installation, but the stale codebase and lack of updates pose long-term compatibility risks.

License in practice: Released under the Unlicense (permissive public domain dedication), which places no restrictions on use, modification, or distribution. This is maximally permissive but also means no warranty or liability protection.

Quickstart:

pip install query-string

import query_string

result = query_string.parse('k=v&k2=v2&k3=v3')
print(result)  # {'k': 'v', 'k2': 'v2', 'k3': 'v3'}

Package is abandoned as of 2020-12-03 with no maintenance; Python version support is unspecified and may not work reliably on modern Python versions.

Verify before relying:

- Whether the package actually works on Python 3.10+ given its abandonment and unspecified Python support.
- Whether standard library urllib.parse.parse_qs or urllib.parse.urlparse would be a better choice for this use case.
- Any known incompatibilities or edge cases in query string parsing that users have encountered.

## Package facts

- License: Unlicense (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 90.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

parse query string, url query parameters, extract url parameters, query string parser, url parsing, get query dict, abandoned, url-parsing

[View on SkillFed](https://skillfed.io/packages/query-string) · [View on PyPI](https://pypi.org/project/query-string/)