GET /api/v1/meAccount identity, key metadata, and granted scopes.
curl "https://xoru.app/api/v1/me" \
-H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/opportunitiesBuyer-intent conversations discovered for your account.
curl "https://xoru.app/api/v1/opportunities?limit=25&offset=0" \
-H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/brand-mentionsMentions of your own brand and product.
curl "https://xoru.app/api/v1/brand-mentions?limit=25&offset=0" \
-H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/competitor-mentionsMentions of the competitors you track.
curl "https://xoru.app/api/v1/competitor-mentions?limit=25&offset=0" \
-H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/topicsYour monitoring terms, keywords, and scan sources.
curl "https://xoru.app/api/v1/topics?limit=25&offset=0" \
-H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/engagementTracked replies, reach, and visibility metrics.
curl "https://xoru.app/api/v1/engagement?limit=25&offset=0" \
-H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/ranking-threadsGoogle Page 1 threads discovered for your tracked keywords.
curl "https://xoru.app/api/v1/ranking-threads?limit=25&offset=0" \
-H "Authorization: Bearer xoru_live_your_key"
POST /api/v1/opportunities/:id/replyGenerate and save a reply draft for an opportunity.
curl -X POST "https://xoru.app/api/v1/opportunities/OPPORTUNITY_ID/reply" \
-H "Authorization: Bearer xoru_live_your_key" \
-H "Content-Type: application/json" \
-d '{"link_preference":"none"}'
POST /api/v1/opportunities/:id/doneMark an opportunity done and record the completion time.
curl -X POST "https://xoru.app/api/v1/opportunities/OPPORTUNITY_ID/done" \
-H "Authorization: Bearer xoru_live_your_key"
POST /api/v1/mentions/:id/saveSave a brand or competitor mention for follow up.
curl -X POST "https://xoru.app/api/v1/mentions/MENTION_ID/save" \
-H "Authorization: Bearer xoru_live_your_key"
POST /api/v1/scansRun an on-demand scan and return the scan summary.
curl -X POST "https://xoru.app/api/v1/scans" \
-H "Authorization: Bearer xoru_live_your_key" \
-H "Content-Type: application/json" \
-d '{"lens":"opportunities"}'
POST /api/v1/ranking-threads/:id/statusUpdate the status of one ranking thread.
curl -X POST "https://xoru.app/api/v1/ranking-threads/RANKING_THREAD_ID/status" \
-H "Authorization: Bearer xoru_live_your_key" \
-H "Content-Type: application/json" \
-d '{"status":"done"}'