Google Currency Conversion Rates Scraper

Google Currency Conversion Rates Scraper

Fetch public Google Finance currency quote pages and calculate conversions from the displayed rate. Each record can include the currency pair, requested amount and converted amount, related currency assets, news, and currency profile. Undisclosed values remain null or empty rather than being guessed. Profile text is provided as readable text and sanitized HTML.

The Actor reads public Google Finance information only. It does not sign in, access private APIs, or bypass access controls. If a page is blocked or unavailable, the run summary and logs report it. proxyConfiguration is accepted for compatibility but does not route requests through a proxy.

Input

The default pair is USD-EUR and the default amount is 1.

{
  "currencyPair": "USD-EUR",
  "amount": 100
}

To fetch a list, provide currencyPairs and set maxPages high enough to cover the selected range. page is the one-based starting position in the deduplicated pair/URL list. currencyPairs, when nonempty, replaces the single currencyPair; startUrls can add supported public Google Finance quote URLs. maxItems is a global cap, and maxResults remains a backward-compatible alias.

{
  "currencyPairs": ["USD-EUR", "GBP-EUR", "JPY-EUR"],
  "amount": 250,
  "page": 1,
  "maxPages": 3,
  "maxItems": 3
}

The input accepts currencyPair or currencyPairs, fromCurrency, toCurrency, and amount, plus public quote URLs in startUrls. page and maxPages select a range from the provided pairs and URLs; maxItems sets a global record limit. maxResults is an alias for maxItems. proxyConfiguration is accepted for compatibility but does not change the connection.

Currency codes must be three letters, and pairs may be written as USD-EUR, USD/EUR, or USDEUR. A malformed explicit pair/code is recorded as an invalid source rather than silently falling back to a different currency pair. startUrls must be HTTPS Google Finance quote pages.

Dataset fields

Every normal output row is one currency-pair quote/conversion and has the same stable top-level shape:

Field group	Fields
Pair and identity	currencyPair, currencyPairLabel, conversionDirection, fromCurrency, toCurrency, fromName, toName, fromSymbol, toSymbol, quoteType, quoteSource, quotePageUrl
Rate and conversion	rate, roundedRate, rateText, rateUnit, inverseRate, inverseRoundedRate, roundingDecimals, amount, amountCurrency, convertedAmount, amountText, convertedAmountText, calculationText
Quote time and movement	quoteTimestamp, quoteTimestampText, quoteDate, quoteTime, quoteTimeZone, changeAbsolute, changePercent, changePeriod, changeText, previousClose, previousCloseText, marketStatus, tradingSession, isIndicative, isRealTime
Related assets	relatedAssets, relatedAssetsCount, hasRelatedAssets
News cards	newsStories, newsStoriesCount, hasNewsStories
Currency profile	profileText, profileHtml, profileUrl, hasProfile

relatedAssets can include currency-pair labels, displayed rates and movements, and links to other quote pages. newsStories can include the publisher, headline, publication wording, article link, and displayed publisher icon. Symbols appear only when explicitly shown; unknown symbols or trading sessions remain null. Yearless quote wording is kept without inventing a calendar date or timestamp.

Example row (the quote values are from a saved historical observation, not a current-rate guarantee):

{
  "currencyPair": "USD-EUR",
  "currencyPairLabel": "USD / EUR",
  "conversionDirection": "USD to EUR",
  "fromCurrency": "USD",
  "toCurrency": "EUR",
  "fromName": "United States Dollar",
  "toName": "Euro",
  "fromSymbol": null,
  "toSymbol": null,
  "rate": 0.872,
  "roundedRate": 0.872,
  "rateText": "0.8720",
  "rateUnit": "EUR per USD",
  "inverseRate": 1.146788990826,
  "inverseRoundedRate": 1.1468,
  "roundingDecimals": 4,
  "amount": 100,
  "amountCurrency": "USD",
  "convertedAmount": 87.2,
  "amountText": "100 USD",
  "convertedAmountText": "87.2 EUR",
  "calculationText": "100 USD = 87.2 EUR",
  "quoteTimestamp": null,
  "quoteTimestampText": "Sep 21, 3:32:19 PM UTC",
  "quoteDate": null,
  "quoteTime": "3:32:19 PM",
  "quoteTimeZone": "UTC",
  "changeAbsolute": 0.00079,
  "changePercent": 0.09,
  "changePeriod": null,
  "changeText": "+0.09%(+0.00079)",
  "previousClose": null,
  "previousCloseText": null,
  "quoteType": "currency",
  "marketStatus": null,
  "tradingSession": null,
  "isIndicative": null,
  "isRealTime": null,
  "quotePageUrl": "https://www.google.com/finance/quote/USD-EUR?hl=en",
  "quoteSource": "Google Finance",
  "relatedAssets": [
    {
      "currencyPair": "JPY-EUR",
      "pairLabel": "JPY / EUR",
      "rate": 0.0055,
      "rateText": "0.0055",
      "changePercent": -0.19,
      "changeText": "-0.19%",
      "quoteUrl": "https://www.google.com/finance/quote/JPY-EUR?hl=en"
    }
  ],
  "relatedAssetsCount": 1,
  "hasRelatedAssets": true,
  "newsStories": [
    {
      "publisher": "FXEmpire",
      "publishedText": null,
      "title": "Copper, EUR/USD and DAX Forecast: Key Breakouts in Focus",
      "articleUrl": "https://www.fxempire.com/forecasts/article/premium-copper-eur-usd-and-dax-forecast-key-breakouts-in-focus-1630456?_c=298531",
      "thumbnailAlt": "FXEmpire",
      "publisherLogoUrl": null
    }
  ],
  "newsStoriesCount": 1,
  "hasNewsStories": true,
  "profileText": "The United States dollar is the official currency of the United States and several other countries.",
  "profileUrl": "https://en.wikipedia.org/wiki/United_States_dollar",
  "hasProfile": true
}

Run summaries and access behavior

The dataset and run summary with source-access information are available in the Output tab. You can download dataset records in formats such as JSON, HTML, CSV, or Excel. If Google blocks a page or no quote can be read, the run summary and logs report the issue instead of adding a conversion record.