API Documentation
RESTful API documentation for developers
https://engage.lotsmcp.comAPI Key (Bearer token or X-API-Key header)
14
Authentication
All API requests require authentication using an API key. You can create an API key from your dashboard.
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://engage.lotsmcp.com/api/v1/lotsengage/projects/:project_id/opportunities/:opportunity_idopportunities
/api/v1/lotsengage/projects/:project_id/opportunities/:opportunity_idGet opportunity
lotsengage_get_opportunityGet one thread, its current reply, and whether it was posted.
/api/v1/lotsengage/projects/:project_id/opportunities/importImport opportunities
lotsengage_import_opportunitiesFile up to 50 threads. Each row reports created, updated, or rejected. A repeated URL updates the same thread and does not wipe a reply already handed, approved, or posted.
/api/v1/lotsengage/projects/:project_id/opportunitiesList opportunities
lotsengage_list_opportunitiesList threads in a project. Filter with platform, fit, or status.
/api/v1/lotsengage/projects/:project_id/opportunitiesSave opportunity
lotsengage_save_opportunityFile one community thread. The same URL updates the same row and does not reopen a thread that is already handed, approved, or posted. platform is reddit, quora, hackernews, forum, facebook_group, or other. fit is strong, partial, or poor. rules is answer_only, disclose_ok, promo_banned, or unknown.
/api/v1/lotsengage/projects/:project_id/opportunities/:opportunity_id/skipSkip opportunity
lotsengage_skip_opportunityMark a thread as not worth an answer. A skipped thread is not drafted again. reason is required.
projects
/api/v1/lotsengage/projectsCreate engage project
lotsengage_create_projectCreate the product to represent in communities, or return the existing project when this owner already used that name. A repeat does not overwrite the saved offer or disclosure line.
/api/v1/lotsengage/projects/:project_idGet engage project
lotsengage_get_projectGet one product plus counts of ready replies, handed replies, approved replies, and posted threads.
/api/v1/lotsengage/projectsList engage projects
lotsengage_list_projectsList the products this owner represents in communities.
/api/v1/lotsengage/projects/:project_idUpdate engage project
lotsengage_update_projectChange the product name, site, offer summary, or disclosure line.
queue
/api/v1/lotsengage/projects/:project_id/queueGet engage queue
lotsengage_get_engage_queueStart every community run here. Returns replies handed to the user, replies approved but not posted, ready replies not yet handed, then at most 3 found threads worth drafting. Skipped, declined, posted, and poor-fit threads are omitted.
replies
/api/v1/lotsengage/projects/:project_id/opportunities/:opportunity_id/handedMark reply handed
lotsengage_mark_handedRecord that the current ready reply was given to the user. reply_id, when sent, must be that current reply.
/api/v1/lotsengage/projects/:project_id/opportunities/:opportunity_id/postedMark thread posted
lotsengage_mark_postedRecord the live URL after the reply is public. posted_by=agent is rejected unless this reply was approved. posted_by=user records a post the person made. A second call returns the original URL.
/api/v1/lotsengage/projects/:project_id/opportunities/:opportunity_id/decisionRecord reply decision
lotsengage_record_decisionRecord the user's decision on the current ready reply. decision is approved or declined.
/api/v1/lotsengage/projects/:project_id/opportunities/:opportunity_id/repliesSave reply
lotsengage_save_replySave the prepared reply for one thread. A product mention requires discloses_ownership and the project disclosure line. promo_banned rejects a product mention. The previous ready reply is superseded.