# CupidBot API

> AI chat generation that funnels men from free platforms to a paid adult platform. Send us the last exchange of a conversation, receive the messages to send next.

Chat and filtering are served from https://chat-api.cupidbotofm.ai, analytics from https://x.cupidbotofm.ai. Authenticate with an `accessToken` field in the request body. Every page below is also available as HTML by dropping the `.md`.

## Introduction

- [Overview](https://www.cupidbotofm.ai/docs/index.md): Base URLs, authentication and a first request against the CupidBot API.
- [Conversation state](https://www.cupidbotofm.ai/docs/conversation-state.md): How we track message history, what counts as a delivered message, and how a conversation ends.
- [Uploading fan media](https://www.cupidbotofm.ai/docs/uploading-media.md): Upload the photos, videos and voice notes he sends to our storage, step by step, with copy-paste code.
- [Errors and rate limits](https://www.cupidbotofm.ai/docs/errors.md): Status codes, how rate limits are calculated, and the backoff we expect from you.

## Endpoints

- [Generate chat response](https://www.cupidbotofm.ai/docs/generate-chat-response.md): Generate the next message in a downstream conversation and funnel the recipient to your paywall.
- [Create media upload URLs](https://www.cupidbotofm.ai/docs/create-media-upload-urls.md): Get signed URLs to upload the media he sends straight to our storage, so you never host fan media yourself.
- [Classify names](https://www.cupidbotofm.ai/docs/classify-names.md): Score profile names for country tier and gender so you can skip low quality traffic.
- [Get analytics](https://www.cupidbotofm.ai/docs/get-analytics.md): Read conversion funnel numbers for your accounts, Cupid Links, creators and presets.

## Reference

- [Schemas](https://www.cupidbotofm.ai/docs/schemas.md): The shared objects used across the API.

## Optional

- [Full reference in one file](https://www.cupidbotofm.ai/llms-full.txt): every page above concatenated.
- [Support on Telegram](https://t.me/CupidBotSupportBot): for anything the docs do not answer.