ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceEmailsSearch emails

Search emails

GET/api/v1/emails

Marketing emails stores sent, newest first. Types come from /facets/email-campaign-types and /facets/email-promotion-types.

Bearer API keyMCP tool search_emails

Query parameters

querystring

Words in subject, sender or body.

shopstring

Store domain.

campaign_typesstring[]

e.g. Newsletter, Welcome.

promotion_typesstring[]

e.g. Discount %, Free Delivery.

languagesstring[]

e.g. english, turkish.

sent_afterstring

ISO date.

sent_beforestring

ISO date.

limitintegerdefault 20

Results per page, 1–50.

cursorstring

The next_cursor of the previous page.

Try it

GET/api/v1/emails?query=black+friday
curl "https://provly.co/api/v1/emails?query=black%20friday" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": [
    {
      "id": "em_7298813",
      "sent_at": "2026-09-21T09:12:00.000Z",
      "subject": "%30 indirim sadece bu hafta 🐾",
      "preheader": "AutoBox'ta sezonun en iyi fiyatı",
      "sender": "Pawfect Co.",
      "campaign_type": "Newsletter",
      "category": "Promotional Campaign",
      "promotion_type": "Discount %",
      "event": null,
      "language": "turkish",
      "country": "TR",
      "screenshot": "https://media.provly.co/emails/em_7298813.png",
      "shop": {
        "domain": "pawfect.co",
        "name": "Pawfect Co.",
        "active_ads": 42
      },
      "body_preview": "Kedinizin kumunu 14 gün boyunca unutun…"
    }
  ],
  "pagination": {
    "total": 1284,
    "next_cursor": "1726908720000"
  }
}