Gmail Inbox Messages - Data API Endpoint

Inbox Messages by oauth access token, pagination token and search query.

Download Gmail Inbox Messages data from the Official Gmail API | 👥  Contributors: steve 🚩  Report

✏️ Inputs

OAuth Access Token auth_token Required

OAuth access token for the Gmail account owning the inbox you’d like to get the messages for. Get your own OAuth token using the Google OAuth Playground. We suggest using the https://www.googleapis.com/auth/gmail.readonly scope.

Pagination Token pagination_token Optional

Used for pagination.

Search Query query Optional

Search for messages in your inbox, from Google:

Only return messages matching the specified query. Supports the same query format as the Gmail search box. For example, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread”. Parameter cannot be used when accessing the api using the gmail.metadata scope.

📝 Notes

Scrape email messages in your GMail inbox using the Official Gmail API, allowing you to mimic exactly how the Gmail website works, but get back your emails as structured data. When using this, you should pay attention to the query parameter, which will allow you to query your inbox using the same search syntax as you do in your normal Gmail and filters, so you can set up an API call to scrape your email messages for certain senders, subject lines, etc… and then scrape the raw content of them on an ongoing basis.

Posted by steve on Feb. 7, 2023, 6:30 a.m. 🚩  Report

⚡️ Endpoint

GET https://www.googleapis.com/gmail/v1/users/me/messages?pageToken={{ pagination_token }}&q={{ query }}

Body

None

Headers

Authorization
Bearer {{auth_token}}