All APIs

Google

Google Events API

Retrieve actual event cards from Google Search. source_surface is search_events; events_available is false when no event pack is shown. The retired immersive Events surface and its pagination are not used.

Make a request

Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.

POST /v1/google/events
curl 'https://api.prismcrawl.com/v1/google/events' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "location": "Chicago,Illinois,United States",
  "query": "concerts in Chicago"
}'

Supported parameters

ParameterUsage
queryRequiredText to search for on the selected service.
countryTwo-letter country or storefront code, such as us or gb.
languageProvider-supported language code, such as en.
locationLocation to search around, such as Austin, TX.
deviceDevice presentation for the source request.

desktop, mobile, tablet

htmlReturn the encoded original response rather than parsed JSON.
zero_traceDo not archive source or parsed response artifacts.

Structured results

Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.

datedate_labelvenuelocationcategorytyperankidtitlenameurlpositionthumbnailratingsnippetdescriptionaddressphonewebsitereview_countrating_maxrating_sourcelatitudelongitudecoordinates

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.