In addition to API bindings, krdict.py provides a scraper module that extends the results of word search queries, advanced search queries, and view queries.

These extensions can be applied directly to results during query calls with the use_scraper option, but are also accessible via the krdict.scraper module.

Extends advanced word search results with pronunciation URLs.

def extend_advanced_search(
    response: WordSearchResults,
    raise_errors: bool
) -> WordSearchResults: ...

Parameters:

  • response: The word search results to extend.
  • raise_errors: Whether errors that occur during scraping should be raised or ignored.

Returns:

Returns an extended WordSearchResults object.

Extends advanced word search results with pronunciation URLs.

def extend_search(
    response: WordSearchResults,
    raise_errors: bool
) -> WordSearchResults: ...

Parameters:

  • response: The word search results to extend.
  • raise_errors: Whether errors that occur during scraping should be raised or ignored.

Returns:

Returns an extended WordSearchResults object.

extend_view

Extends view query results with pronunciation URLs, multimedia information, and extended hanja information.

def extend_view(
    response: ViewResult,
    fetch_page_data: bool,
    fetch_multimedia: bool,
    raise_errors: bool
) -> ViewResult: ...

Parameters:

  • response: The word search results to extend.
  • fetch_page_data: Whether page data (URLs and hanja information) should be scraped.
  • fetch_multimedia: Whether multimedia URLs should be scraped.
  • raise_errors: Whether errors that occur during scraping should be raised or ignored.

Returns:

Returns an extended ViewResult object.

fetch_daily_word

Fetches the Korean word of the day by scraping the dictionary website.

def fetch_daily_word() -> DailyWordResponse: ...

Returns:

Returns a DailyWordResponse object.