manatal
Unofficial Python client for the Manatal Open API v3.
Disclaimer: This is a personal, community package — not an official Manatal product.
Install
pip install manatal
Quick start
from manatal import Manatal
client = Manatal(api_key="YOUR_OPEN_API_TOKEN")
# or: export MANATAL_API_KEY=...
candidate = client.candidates.create(
full_name="Jane Doe",
email="jane@example.com",
)
print(candidate["id"])
for job in client.jobs.list():
print(job["id"], job.get("position_name"))
Get an API token from the Manatal app (API users) or via support.
Features
Authorization: Token …auth againsthttps://api.manatal.com/open/v3- Proactive client rate limit (default 90 req/min, under the API’s 100/min)
- Automatic 429 retries using
Retry-After - Pagination helpers (
list()walks all pages; defaultpage_size=100) - Typed exceptions for 400 / 401 / 403 / 404 / 429
- Resources: candidates, jobs, organizations, matches, contacts, users, lookups, plus nested notes/attachments/activities/etc.
Resources
client.candidates.list(email="jane@example.com")
client.candidates.retrieve(123)
client.candidates.update(123, phone_number="+10000000000")
client.candidates.notes(123).create(info="Called candidate")
client.jobs.create(organization=1, position_name="Engineer")
client.matches.create(candidate=123, job=456)
client.organizations.list()
client.contacts.list()
client.users.list()
client.currencies.list()
client.match_stages.list()
client.skills.list()
Single page:
page = client.candidates.list_page(page=1, page_size=50)
print(page.count, len(page.results))
Errors
from manatal import Manatal, RateLimitError, NotFoundError
try:
client.candidates.retrieve(999999)
except NotFoundError as exc:
print(exc.status_code, exc.body)
Backend-friendly defaults
Manatal Open API throttles at 100 requests/minute per token. This client:
- Soft-limits locally to ~90/min
- On 429, sleeps for
Retry-Afterand retries - Uses
page_size=100by default to reduce round-trips - Sends
User-Agent: manatal-python/x.y.z
License
MIT
manatal-python
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
manatal-0.1.0.tar.gz
(9.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
manatal-0.1.0-py3-none-any.whl
(13.5 kB
view details)
File details
Details for the file manatal-0.1.0.tar.gz.
File metadata
- Download URL: manatal-0.1.0.tar.gz
- Upload date:
- Size: 9.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f9872e75192ca980a8885f0214a584ef060366d8e32018a7bb1dc196783e11b
|
|
| MD5 |
128e11eb4ac8ce0984699d4ae5ede0e6
|
|
| BLAKE2b-256 |
0abeb90c9e9a1f6c3011902836a49150dc2f8af9f4faeffe133de4447f632b65
|
Provenance
The following attestation bundles were made for manatal-0.1.0.tar.gz:
Publisher:
publish.yml on TasfiqulGhani/manatal-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
manatal-0.1.0.tar.gz -
Subject digest:
3f9872e75192ca980a8885f0214a584ef060366d8e32018a7bb1dc196783e11b - Sigstore transparency entry: 2467348844
- Sigstore integration time:
-
Permalink:
TasfiqulGhani/manatal-python@43da9fffe5c1fdd7e8f4e4abc627359b208e5626 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/TasfiqulGhani
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@43da9fffe5c1fdd7e8f4e4abc627359b208e5626 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file manatal-0.1.0-py3-none-any.whl.
File metadata
- Download URL: manatal-0.1.0-py3-none-any.whl
- Upload date:
- Size: 13.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f3c1ca1430abca77a1cd8f15f8122968a9bf6c2b166d479d5f46564dc1a1212
|
|
| MD5 |
23efeac5081ea0eb1a2af50faeaff0d5
|
|
| BLAKE2b-256 |
0cdb9b0b00474a63ae70a61a961ff2905fb8fe78b87c2ee986e8200f9ffd2289
|
Provenance
The following attestation bundles were made for manatal-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on TasfiqulGhani/manatal-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
manatal-0.1.0-py3-none-any.whl -
Subject digest:
7f3c1ca1430abca77a1cd8f15f8122968a9bf6c2b166d479d5f46564dc1a1212 - Sigstore transparency entry: 2467349192
- Sigstore integration time:
-
Permalink:
TasfiqulGhani/manatal-python@43da9fffe5c1fdd7e8f4e4abc627359b208e5626 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/TasfiqulGhani
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@43da9fffe5c1fdd7e8f4e4abc627359b208e5626 -
Trigger Event:
workflow_dispatch
-
Statement type:
