This is the documentation to use the Pépito API.
It will let you know when Pépito is in or out with the corresponding picture.

Endpoint

https://api.thecatdoor.com/sse/v1/events

Response Example

{"event":"heartbeat","time":1725714568}
{"event":"heartbeat","time":1725714578}
{"event":"pepito","type":"in","time":1725714575,"img":"https://storage.thecatdoor.com/assets/1725714575-in-799154526.jpg"}
{"event":"heartbeat","time":1725714588}
{"event":"heartbeat","time":1725714598}
{"event":"pepito","type":"out","time":1725715521,"img":"https://storage.thecatdoor.com/assets/1725715521-in-722148161.jpg"}
{"event":"heartbeat","time":1725715532}

Endpoint

https://api.thecatdoor.com/rest/v1/last-status

Response Example

{
    "event": "pepito",
    "type": "in",
    "time": 1753422874,
    "img": "https://storage.thecatdoor.com/assets/1753422874-in-181661935.jpg"
}

Go to examples to see some basic client examples.

• X - https://x.com/pepitothecat
• TikTok - https://www.tiktok.com/@pepitothecat2007

Add yours here using PR or issue

• BlueSky - https://bsky.app/profile/pepitothe-cat.bsky.social
• BlueSky - https://bsky.app/profile/pepitocat.bsky.social
• Tumblr - https://www.tumblr.com/pepitothecat (#6)
• Discord - Discord Bot Invite (#7 Source Code)
• Mastodon - https://mastodon.social/@PepitoTheCat (#2)
• Threads - https://www.threads.net/@pepito.thecat
• Telegram - Bot name @Pepito_IO_Bot - https://github.com/sensifier/PEPITO
• Is-Pepito-out frontend - https://is-pepito-out.vercel.app/

You are free to use this API for non-commercial usage.
If you use it to publish on a public platform (like Bluesky, Mastodon, Threads, etc.), you must specify that it's an unofficial account.
Additionally, please add the account link to the list above.

For any question, please submit an issue or send me a Private Message on X.