API Endpoints

GET /

Health check used by the API hoster.

Response

{ "name": "InceLexicon", "status": "ok" }

GET /get_raw

Return previously scraped raw data. Defaults to today's data.

Query Parameters

• date - Optional. Date in YYYY-MM-DD format. Defaults to today's date.

Response

Returns the raw records for the requested date.

GET /get_top_n

Return the n most frequently used words for a particular day. Defaults to today's data and 500 words.

Query Parameters

• date - Optional. Date in YYYY-MM-DD format. Defaults to today's date.
• n - Optional. Number of words to return. Defaults to 500. Maximum is 5000.

Response

{ "date": "YYYY-MM-DD", "count": 10, "words": [...] }

GET /get_bottom_n

Return the n least frequently used words for a particular day. Defaults to today's data and 500 words.

Query Parameters

• date - Optional. Date in YYYY-MM-DD format. Defaults to today's date.
• n - Optional. Number of words to return. Defaults to 500. Maximum is 5000.

Response

{ "date": "YYYY-MM-DD", "count": 10, "words": [...] }

GET /get_word_dict

Return statistics for every word in the dataset.

Response

Returns the word statistics as JSON.

GET /get_word

Return statistics for a specific word in the dataset.

Query Parameters

• word - Optional. The word to retrieve statistics for. Defaults to incel.

Response

Returns the statistics for the requested word as JSON.