Gemini Scraper

scraper.gemini extracts Gemini responses so you can archive Google AI outputs with structured citation metadata.

Request Example

curl 'https://api.scrapeless.com/api/v2/scraper/request' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: {you_api_key}' \
  --data '{
    "actor": "scraper.gemini",
    "input": {
      "prompt": "Recommended attractions in New York",
      "country": "US"
    },
    "webhook": {
      "url": "http://www.youwebhook.com"
    }
  }'

Body Parameters

ParameterTypeRequiredDescription
promptstringYesPrompt sent to Gemini.
countrystringYesCountry or region code.
shoppingbooleanNoWhether to fetch shopping data. Defaults to false. When enabled, the response includes extra product information in the products field — the merchant offers behind each product cluster, such as direct store URL, price, installments, stock, delivery, and returns.

Response Fields

Note: When shopping is enabled and the response returns this extra product information, the API call will be charged at 2x the base rate. This is due to the additional resource overhead required for extracting and processing product information from multiple sources.

ParameterTypeDescription
result_textstringMarkdown response.
promptstringOriginal prompt.
citationsarrayCitation metadata.
citations.faviconstringFavicon URL.
citations.highlightsarrayHighlighted snippets from the source text.
citations.snippetstringCitation snippet.
citations.titlestringTitle of the cited page.
citations.urlstringURL of the cited page.
citations.website_namestringWebsite name.
related_queriesarrayArray of fan-out queries.
productsarrayProduct information returned by Google Gemini.
products.thumbnailsarrayArray of product thumbnail image URLs.
products.titlestringProduct title.
products.urlstringProduct page URL.
products.brandstringProduct brand name.
products.reviewsintNumber of reviews.
products.ratingstringAverage rating score.
products.price_rangestringPrice range, e.g., $2,499.99.
products.storesarrayArray of store offers.
products.stores.namestringStore name.
products.stores.linkstringStore product link.
products.stores.titlestringProduct title at the store.
products.stores.ratingsstringStore rating, e.g., 4.3/5.
products.stores.extensionsarrayAdditional info (stock, delivery, returns).
products.stores.pricestringStore price.
products.stores.delivery_feestringDelivery fee information.
products.stores.total_pricestringTotal price including fees.
products.about_the_productobjectDetailed product information.
products.about_the_product.titlestringSection title.
products.about_the_product.linkstringProduct page link.
products.about_the_product.displayed_linkstringDisplayed domain name.
products.about_the_product.featuresarrayProduct features/specifications.
products.about_the_product.features.titlestringFeature name.
products.about_the_product.features.valuestringFeature value.
products.about_the_product.descriptionstringProduct description.
products.variantsarrayProduct variant options.
products.variants.titlestringVariant category title.
products.variants.itemsarrayVariant options list.
products.variants.items.namestringVariant option name.
products.variants.items.selectedboolWhether this variant is selected.
products.variants.items.availabilityboolVariant availability status.
products.ratingsarrayRating distribution data.
products.ratings.starsintStar rating level (1-5).
products.ratings.amountintNumber of ratings at this level.
products.user_reviewsarrayUser review data.
products.user_reviews.textstringReview text content.
products.user_reviews.sourcestringReview source platform.
products.user_reviews.ratingintUser rating score.
products.user_reviews.datestringReview date.
products.user_reviews.namestringReviewer name.
products.user_reviews.titlestringReview title.