gfg-search

gfg-search is an unofficial Python client for the GeeksforGeeks search API.

It wraps the endpoint:

https://www.geeksforgeeks.org/gfg-assets/_next/data/<build-id>/search.json?gq=<query>

and automatically discovers the current <build-id> from the GeeksforGeeks homepage.

Features

• Simple one-line search function.
• Reusable client class with connection/session reuse.
• Typed result model via dataclass.
• Raw response access when needed.

Installation

From PyPI (after publishing):

pip install gfg-search

From local source:

pip install .

Quick Start

from gfg_search import search

results = search("dsa", max_results=5)
for item in results:
    print(item.title)
    print(item.link)
    print(item.snippet)
    print("-")

Client Usage

from gfg_search import GFGSearchClient

client = GFGSearchClient(timeout=12)
results = client.search("python")

first = results[0]
print(first.title)
print(first.link)

Raw Response Usage

from gfg_search import GFGSearchClient

client = GFGSearchClient()
raw_items = client.search_raw("graph")

print(type(raw_items))
print(raw_items[0].keys())

API Reference

search(query, *, max_results=None, timeout=10.0)

• query (str): Search text.
• max_results (int | None): Limit the number of returned results.
• timeout (float): Timeout (seconds) for HTTP requests.

Returns list[SearchResult].

GFGSearchClient(timeout=10.0, base_url="https://www.geeksforgeeks.org", session=None)

Methods:

• search(query, *, max_results=None) -> list[SearchResult]
• search_raw(query) -> list[dict]

SearchResult

Main fields:

• title
• link
• snippet
• display_link
• formatted_url
• html_title
• html_snippet
• kind
• pagemap

Error Handling

from gfg_search import GFGSearchClient, GFGSearchHTTPError, GFGSearchParsingError

client = GFGSearchClient()

try:
    print(client.search("dynamic programming", max_results=3))
except GFGSearchHTTPError as exc:
    print("Network error:", exc)
except GFGSearchParsingError as exc:
    print("Response format error:", exc)

Notes

• This package is unofficial and not affiliated with GeeksforGeeks.
• Since this endpoint is internal to their web app, response shape or route behavior may change in future.

Development

Run a local editable install:

pip install -e .

Build distribution artifacts:

python -m build

License

MIT