Registry / communication / kakao
library2025-latestpypypi✓ verified 26d ago

Kakao REST API provides access to Kakao Login, KakaoTalk messaging, friends list, maps, and AI features. Primary documentation is in Korean. English docs exist but are incomplete and lag behind Korean versions. No official Python/Node package — all integrations use REST API directly with app keys.

pip install requests
INSTALL
IMPORT
SIG · KAKAO
K
kakao
communicationpythonv2025-latest
Install
2.1s avg
Import
Disk
105MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v? · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 69.9MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 2.1s · import 0.000s · 141MB
105MB installed
● package 105MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Authorization header
Authorization: KakaoAK {REST_API_KEY}
Authorization: Bearer {REST_API_KEY}
Kakao uses KakaoAK prefix for app-level auth, not Bearer. Bearer is only for user access tokens.
User token auth
Authorization: Bearer {ACCESS_TOKEN}
Use Bearer only when authenticating as a user with an access token from OAuth flow.

Retrieve Kakao user info using a valid access token.

import requests # Get user info with access token headers = { 'Authorization': f'Bearer {ACCESS_TOKEN}' } response = requests.get( 'https://kapi.kakao.com/v2/user/me', headers=headers ) print(response.json())
Debug
Known issues
breakingClient secret is now enabled by default for all new REST API keys. Omitting client_secret in token requests causes KOE101 error.
fix
Include client_secret parameter in all Get token API calls, or disable Client secret in app settings
affects: all
breakingAccess tokens expire in 6 hours. Refresh tokens expire in 60 days (extendable to 2 months). Expired access token returns error code -401.
fix
Implement token refresh using refresh_token before expiry. Check error code -401 and refresh proactively.
affects: all
gotchaError codes are negative integers with no consistent pattern. code:-401 can mean token expired, token not found, or app key deactivated — check msg field for the actual cause.
fix
Always read the msg field in error responses, not just the code
affects: all
gotchaPrimary documentation is in Korean at developers.kakao.com. English docs exist but are incomplete and often lag Korean versions by weeks.
fix
For complete specs use Korean docs at developers.kakao.com/docs/latest/ko/ — use translation tools if needed
affects: all
gotchaToken issuance rate limit returns KOE237 error. Not documented clearly in English docs.
fix
Implement exponential backoff on KOE237. Check Korean troubleshooting docs for current limits.
affects: all
gotchaScope/consent items must be pre-configured in Kakao Developers app settings before requesting. Missing scope returns -402 insufficient scopes error.
fix
Configure all required consent items in app settings at developers.kakao.com before going to production
affects: all
gotchaAdmin key has full permissions and must never be exposed client-side. Reissuing app keys is irreversible — all existing keys stop working immediately.
fix
Use Admin key only in server-side code. Store in environment variables only.
affects: all
breakingThe ACCESS_TOKEN variable must be defined and populated (e.g., from an environment variable, configuration file, or a successful token retrieval API call) before being used in API requests.
fix
Ensure ACCESS_TOKEN is properly defined and assigned a valid value (such as by loading it from an environment variable or obtaining it via an authentication flow) before it is referenced in API calls.
affects: all
gotchaA NameError: name 'ACCESS_TOKEN' is not defined indicates that the variable was used without being assigned a value. Ensure all variables are defined before use.
fix
Define or assign a value to 'ACCESS_TOKEN' before it is used, for example, by loading it from an environment variable, a configuration file, or directly assigning it in the script.
affects: all
Upgrade
Version history
2025-latestlatest on PyPI
Audit
Dependencies
kakao_flutter_sdkoptionalOfficial SDK for Flutter/Android/iOS only. No official Python or Node SDK exists.
Agent activity
19 hits · last 30 days
node
16
OpenAI (training)
1
Resources