GeoScraper API Documentation - Google Maps Posts API

Google Maps Posts API

This endpoint enables you to scrape posts from a Google Maps business listing.

Endpoint

POST: https://api.geoscraper.net/google/map/posts

Headers

X-Berserker-Token: Your_Access_Token
Content-Type: application/json

Request Body

Format: JSON
Fields:
- data_id (required): The unique identifier for the place.
- hl (optional): Language parameter to specify the response language.
- catched (optional): Boolean to indicate if cached data should be used.
- token (optional): Token for the next page (obtainable from the first page response).

Sample Request

import requests
import json

url = "https://api.geoscraper.net/google/map/posts"

payload = json.dumps({
  "data_id": "0x3ae33f8ee1c9f54f:0xe28de46119ba485e",
  "hl": "en",
  "catched": True,
  "token": ""
})
headers = {
  'X-Berserker-Token': 'Your_Access_Token',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Sample Response

[
    {
        "description": "The unix time stamp is a way to track time as a running total of seconds. This count starts at the Unix Epoch on January 1st, 1970 at UTC. Therefore, the unix time stamp is merely the number of seconds between a particular date and the Unix Epoch. It should also be pointed out (thanks to the comments from visitors to this site) that this point in time technically does not change no matter where you are located on the globe. This is very useful to computer systems for tracking and sorting dated information in dynamic and distributed applications both online and client side.",
        "post_link": "https://search.google.com/local/posts?q=TwoZeroTwo+LLC&ludocid=16324955329982515294&lpsid=CIHM0ogKEKW058yBh4nA8wE&source=sh/x/localposts&lsig=AB86z5UOCeiqz1s8JcaduizCJnhD",
        "action": "Call now",
        "action_call_to_action": "+16202024222",
        "post_type": "Update",
        "posted_at_timestamp": 1753327856,
        "source": "TwoZeroTwo LLC",
        "source_logo": "https://lh6.googleusercontent.com/-FLDSC0IxKFs/AAAAAAAAAAI/AAAAAAAAAAA/RpS-LcUER40/s40-c-k-mo/photo.jpg",
        "posted_at": "2025-07-24 03:30:56 UTC",
        "posted_at_utc": "2025-07-24 03:30:56 UTC",
        "title": null,
        "thumbnails": null,
        "action_value": null,
        "from_timestamp": null,
        "to_timestamp": null
    },
    {
        "title": "event",
        "description": "eventyyyyy",
        "post_link": "https://search.google.com/local/posts?q=TwoZeroTwo+LLC&ludocid=16324955329982515294&lpsid=CIHM0ogKELutwpbtvbP9jgE&source=sh/x/localposts&lsig=AB86z5UOCeiqz1s8JcaduizCJnhD",
        "thumbnails": [
            {
                "url": "https://lh3.googleusercontent.com/geougc/AF1QipNdalFsOGAYP5TIqA2EA_Y-PPHrlQxSwiX98xqK=h400-no",
                "thumbnail_id": "AF1QipNdalFsOGAYP5TIqA2EA_Y-PPHrlQxSwiX98xqK"
            }
        ],
        "action": "Sign up",
        "action_value": "http://example.com/sdsdf",
        "post_type": "Event",
        "posted_at_timestamp": 1753290460,
        "from_timestamp": 1753218000,
        "to_timestamp": 1753412400,
        "source": "TwoZeroTwo LLC",
        "source_logo": "https://lh6.googleusercontent.com/-FLDSC0IxKFs/AAAAAAAAAAI/AAAAAAAAAAA/RpS-LcUER40/s40-c-k-mo/photo.jpg",
        "posted_at": "2025-07-23 17:07:40 UTC",
        "posted_at_utc": "2025-07-23 17:07:40 UTC",
        "from": "2025-07-22 21:00:00 UTC",
        "from_utc": "2025-07-22 21:00:00 UTC",
        "to": "2025-07-25 03:00:00 UTC",
        "to_utc": "2025-07-25 03:00:00 UTC"
    },
    {
        "title": "offer",
        "description": "fsdv",
        "post_link": "https://search.google.com/local/posts?q=TwoZeroTwo+LLC&ludocid=16324955329982515294&lpsid=CIHM0ogKEK2ugeC0zMqrpgE&source=sh/x/localposts&lsig=AB86z5UOCeiqz1s8JcaduizCJnhD",
        "action": "View Offer",
        "action_value": "https://search.google.com/local/posts?q=TwoZeroTwo+LLC&ludocid=16324955329982515294&lpsid=1475222265772701551&source=sh/x/localposts&lsig=AB86z5UOCeiqz1s8JcaduizCJnhD",
        "post_type": "Offer",
        "posted_at_timestamp": 1753290416,
        "from_timestamp": 1753209000,
        "to_timestamp": 1753468199,
        "source": "TwoZeroTwo LLC",
        "source_logo": "https://lh6.googleusercontent.com/-FLDSC0IxKFs/AAAAAAAAAAI/AAAAAAAAAAA/RpS-LcUER40/s40-c-k-mo/photo.jpg",
        "posted_at": "2025-07-23 17:06:56 UTC",
        "posted_at_utc": "2025-07-23 17:06:56 UTC",
        "from": "2025-07-22 18:30:00 UTC",
        "from_utc": "2025-07-22 18:30:00 UTC",
        "to": "2025-07-25 18:29:59 UTC",
        "to_utc": "2025-07-25 18:29:59 UTC",
        "thumbnails": null
    },
    {
        "description": "update",
        "post_link": "https://search.google.com/local/posts?q=TwoZeroTwo+LLC&ludocid=16324955329982515294&lpsid=CIHM0ogKENrr9bn4ldfkxAE&source=sh/x/localposts&lsig=AB86z5UOCeiqz1s8JcaduizCJnhD",
        "thumbnails": [
            {
                "url": "https://lh3.googleusercontent.com/geougc/AF1QipNFNvMILjGBKKzyfzT5MbacVKecYJLHw0M5uIM0=h400-no",
                "thumbnail_id": "AF1QipNFNvMILjGBKKzyfzT5MbacVKecYJLHw0M5uIM0"
            }
        ],
        "action": "Learn more",
        "action_value": "http://example.com/",
        "post_type": "Update",
        "posted_at_timestamp": 1753290378,
        "source": "TwoZeroTwo LLC",
        "source_logo": "https://lh6.googleusercontent.com/-FLDSC0IxKFs/AAAAAAAAAAI/AAAAAAAAAAA/RpS-LcUER40/s40-c-k-mo/photo.jpg",
        "posted_at": "2025-07-23 17:06:18 UTC",
        "posted_at_utc": "2025-07-23 17:06:18 UTC",
        "title": null,
        "from_timestamp": null,
        "to_timestamp": null
    },
    {
        "next_page_token": ""
    }
]

Description

The response includes a list of posts from the specified Google Maps business listing. Each post contains details like the description, post link, action buttons, post type, timestamps, and source information. The next_page_token can be used to paginate through additional posts.

Note: Replace Your_Access_Token with your actual API access token.