HeyRepli API Documentation

HeyRepli is a 4-in-1 AI social concierge for small business. All endpoints use 100% official APIs (OAuth) and never scrape.

Quickstart

Sign up to get your API key, then call any endpoint:

curl -H "X-API-Key: sk_your_key" "https://api.heyrepli.com/api/v1/listen/mentions"

AI Engagement

POST /api/v1/ai/rewrite (engagement mode)

Generate AI-suggested reply to a comment or DM. Default mode requires human approval before publishing.

curl -X POST -H "X-API-Key: sk_xxx" -H "Content-Type: application/json" -d {"platform":"instagram","text":"Is this in stock?","tone":"friendly"} "https://api.heyrepli.com/api/v1/ai/rewrite"

Supports 30+ languages. Brand voice training via brand_voice table.

Engagement Models

  • deepseek-v4-flash - Primary (cost-effective)
  • kimi-k3 - Chinese long-form
  • grok-4.6 - High-end scenarios
  • gpt-4o - Premium option

Brand Monitoring

GET /api/v1/listen/mentions

List recent brand mentions across X, Reddit, news, and Hacker News with AI sentiment analysis.

curl -H "X-API-Key: sk_xxx" "https://api.heyrepli.com/api/v1/listen/mentions?sentiment=negative&limit=50"

Cron-triggered every 12 hours via Worker. AI sentiment runs automatically on new mentions.

Monitor Configuration

curl -X POST -H "X-API-Key: sk_xxx" -H "Content-Type: application/json" -d {"keyword":"heyrepli","type":"brand","platforms":["x","reddit","news"]} "https://api.heyrepli.com/api/v1/listen/keywords"

AI Rewriting

POST /api/v1/ai/rewrite

Rewrite content in 5 styles across 7+ platforms. Supports brand voice training.

curl -X POST -H "X-API-Key: sk_xxx" -H "Content-Type: application/json" -d {"text":"We launched HeyRepli!","style":"professional","platform":"linkedin","provider":"deepseek"} "https://api.heyrepli.com/api/v1/ai/rewrite"

Styles

  • professional - B2B / executive tone
  • casual - Conversational / DTC brand
  • funny - Witty / entertainment
  • story - Narrative / long-form
  • promo - Direct response / conversion

Smart Scheduling

POST /api/v1/publish/jobs

Schedule posts to multiple platforms at once. Cron triggers publish every 5 minutes.

POST /api/v1/publish/connect/twitter
POST /api/v1/publish/jobs {"socialAccountId":"uuid","content":"Hello!","scheduledAt":"2026-08-23T10:00:00Z"}

OAuth Connection

All platform connections use 100% official OAuth flows. We never store passwords. Supported platforms:

  • Instagram, Facebook, Threads (via Meta Graph)
  • X / Twitter (via X OAuth 2.0)
  • LinkedIn Profile + Company Page (via LinkedIn API)
  • TikTok (via TikTok Display API)
  • YouTube (via Google OAuth)

Errors

  • 401 UNAUTHORIZED - Missing or invalid X-API-Key
  • 429 QUOTA_EXCEEDED - Monthly quota exceeded
  • 429 RATE_LIMIT - Too many requests
  • 400 INVALID_INPUT - Bad request body
  • 500 INTERNAL - Server error