iMessage by PhotonInstall

Summary

Searches iMessage messages on the Photon server for text containing a query string, either across all chats or within one chat, and returns each matching message as its own item.

Inputs

• Query (required) — Text to look for. Sent as a substring match (SQL LIKE %query%) against message text.
• Return All — If true, requests up to 1000 results (a fixed cap, not unlimited). Default false.
• Limit — Max results to return when Return All is off. Minimum 1, default 50.
• Additional Fields > Chat GUID — Restrict the search to one chat (e.g. iMessage;-;+1234567890). A bare address or a GUID with a different service prefix is also tried as iMessage;/any; variants. Empty searches all chats.
• Additional Fields > Sort — Newest First (DESC, default) or Oldest First (ASC).

Output shape

One output item per matching message, containing the message object as returned by the Photon /api/v1/message/query endpoint. Each item is paired to its input item.

Returns no items if nothing matches. Return All is capped at 1000. With a Chat GUID, the variants are tried in order and the first non-empty result is returned. The search does not request related data (chat, handle, attachments), unlike Get Messages. With Continue On Fail, errors are emitted as an item with an error message.

Examples

Example 1: Find the latest messages mentioning an invoice across all conversations

Query: "invoice"; Return All off; Limit 20; Sort: Newest First

Example 2: Search one DM's full history for a keyword, oldest first

Query: "address"; Return All on; Additional Fields: Chat GUID iMessage;-;+15551234567, Sort Oldest First

Links

• n8n community nodes installation guide