Data, part 3 of 3 (27 tools)
Reads of Rewalto's data. The ones marked as spending credits charge only for data delivered.
list_place_reviews
Newest reviews of one place on Google Maps or Tripadvisor. Rewalto's newest public reviews of one place (the placeId search_places gives), with its overall rating: stars, title, text, date, visit date and the owner's reply. Reviewer names are not kept. Charged per review delivered at the history rate. Every reading is kept as Rewalto history; the same request read in the last 24 hours answers from it (meta.reused). A new reading takes a minute or two: the first call answers data.status "pending" with meta.retryAfterSeconds and charges nothing; call again with the same arguments to collect it. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- source (string, required): google_maps or tripadvisor.
- placeId (string, required): A Google Maps place id (ChIJ...) or a Tripadvisor page path, as search_places gives it.
- depth (string, optional): Reviews to read: 20 (default), 50 or 100.
list_price_parity
Price parity across retailers. One product (product id, or retailer with retailerSku): for each IST day it was priced, every matched listing's newest price per pin code, the lowest and highest, and the gap in paise and basis points. Newest day first (default the last 30 days, at most 92), optionally one pin code. Charged per day at the history rate. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- product (string, optional): A Rewalto product id (uuid).
- retailer (string, optional): With retailerSku: start from this listing (a retailer key).
- retailerSku (string, optional): With retailer: the retailer's own product id.
- pincode (string, optional): Only prices at this six-digit pin code, or national.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD (default today).
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_price_per_unit
Price per unit. For one retailer: each product's price per gram, millilitre or piece on each IST day at each pin code (or national), per pack, with the lowest, highest and mean in paise per unit and the selling prices; a pack that could not be read has an empty price per unit. Newest day first; optionally one product, one pin code and a day range. Charged per data point at its published rate; re-reading within 7 days is free. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- retailer (string, required): A retailer key, from list_retailers.
- retailerSku (string, optional): The retailer's own product id.
- pincode (string, optional): A six-digit pin code, or national.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_product_listings
One product across retailers. One product (product id, or retailer with retailerSku to start from one listing): every retailer listing Rewalto's matcher matched to it, with each listing's newest price, MRP and stock per pin code (or national) in a window of IST days (default 7, at most 31). Ordered by retailer, listing and pin code. Charged per record at the listings rate. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- product (string, optional): A Rewalto product id (uuid).
- retailer (string, optional): With retailerSku: start from this listing (a retailer key).
- retailerSku (string, optional): With retailer: the retailer's own product id.
- pincode (string, optional): Only this six-digit pin code, or national.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD (default today).
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_promo_emails
Brand promo emails. Each promotion a brand emailed to subscribers, as recorded by Rewalto: send day, brand, offer, sale dates and discount code if stated, and the brand's linked page; never the email itself. Newest send day first; optionally one brand and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- brand (string, optional): A canonical brand (exact), as in the brand field.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_rating_changes
Rating changes. For one retailer: each product's rating, rating count and review count on every IST day one of them changed, per pin code (or national). Newest day first; optionally one product, one pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- retailer (string, required): A retailer key, from list_retailers.
- retailerSku (string, optional): The retailer's own product id.
- pincode (string, optional): A six-digit pin code, or national.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_regulatory_notices
Regulatory notices (CDSCO, FSSAI). Public notices from India's drug regulator (CDSCO public notices) and food regulator (FSSAI notifications), read weekly: title, release day, the document's link and size, and for FSSAI its category (draft, gazette, notice, sps, tbt, ordinary), comments link and further documents; never the document itself. Newest release day first; optionally one regulator, a day range and words in the title. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- authority (string, optional): cdsco or fssai.
- from (string, optional): First release day, YYYY-MM-DD.
- to (string, optional): Last release day, YYYY-MM-DD.
- q (string, optional): Words the title contains (any case).
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_retailers
Retailers with data. The retailers Rewalto holds commerce data for. Free. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- Free
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- None
list_search_ranks
Search rank history. For one retailer: per IST day, search term, pin code (or national) and listing, its best place in the whole result list (null where the reply does not state its page start), the first page and slot it was seen at, and how many replies showed it, placed it in the top 10 and marked it sponsored. Newest day first; optionally one product (retailerSku), search term, pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- retailer (string, required): A retailer key, from list_retailers.
- retailerSku (string, optional): The retailer's own product id.
- searchTerm (string, optional): A search term (exact).
- pincode (string, optional): A six-digit pin code, or national.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_share_of_search
Share of search. For one retailer: per IST day, search term, pin code (or national) and brand, the brand's share of the first ten places (organic and sponsored together) over every reply read that day, how much of it was sponsored, and how many of its listings reached the top 10. Newest day first; optionally one brand, search term, pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- retailer (string, required): A retailer key, from list_retailers.
- brand (string, optional): A brand, as the retailer writes it (exact).
- searchTerm (string, optional): A search term (exact).
- pincode (string, optional): A six-digit pin code, or national.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_stock_states
Stock states. For one retailer: each product's stock state at the close of each IST day at each pin code (in, low, out, delisted or unknown), whether out at that pin only or everywhere, the stock count where shown, and the days in a row out or gone. Newest day first; optionally one product, one pin code, one state and a day range. Charged per stock state at its published rate; re-reading within 7 days is free. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- retailer (string, required): A retailer key, from list_retailers.
- retailerSku (string, optional): The retailer's own product id.
- pincode (string, optional): A six-digit pin code, or national.
- stockState (string, optional): in, low, out, delisted or unknown.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_storefront_changes
Storefront changes. What D2C stores changed between reads: products launched or delisted, variant price changes (old and new price and struck-through price, minor units), promotions (struck-through price moved, price held) and stock changes. Newest first; optionally one store (host), one kind of change and an IST day range. Charged per change at the listings rate. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- host (string, optional): One store, by host name, e.g. www.mamaearth.in.
- change (string, optional): launched, delisted, price_changed, promotion_changed or stock_changed.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_storefront_products
Storefront catalogue and prices. Product variants on D2C stores' own catalogues as Rewalto last read them: name, variant, brand, SKU, barcode, price and struck-through price in minor units (paise for INR), in stock or not, tags, image addresses, first and last seen. Filter by one store (host), a name search (q), a brand or a barcode; sku needs host. Charged per variant at the listings rate. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- host (string, optional): One store, by host name, e.g. www.mamaearth.in.
- q (string, optional): Product name contains this text (3 to 100 characters).
- brand (string, optional): One brand (case-insensitive exact).
- barcode (string, optional): One barcode (GTIN/EAN).
- sku (string, optional): One SKU (exact; with host).
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_storefront_promos
D2C promo calendar. For each watched brand store and IST day: variants seen and on sale, the median and deepest discount (basis points), and how many went on sale, ended a sale, were cut in price or discounted deeper. Newest day first; optionally one brand, one store and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- brand (string, optional): A brand (exact).
- domain (string, optional): A watched store, e.g. mamaearth.in.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_storefronts
Storefront platforms. D2C online stores in Rewalto's storefront index with the platform that runs each (shopify, woocommerce, magento, fynd, unicommerce and others): platform confidence, market, when Rewalto first and last read the store, and how many products and variants Rewalto holds from its catalogue. In host order; optionally one store, one platform and one market. Charged per store at the listings rate. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- host (string, optional): One store, by host name, e.g. www.mamaearth.in.
- platform (string, optional): One platform, e.g. shopify or woocommerce.
- market (string, optional): One market, an ISO country code, e.g. IN.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
list_units
Units left and units gone. For one retailer: each product's units per pin code and IST day: units left at the last reading, first, fewest and most, and units gone between readings (a lower bound on units sold; rises count as restocks). unitsFrom: the app's counter (Blinkit, Zepto, Myntra, Nykaa) or Flipkart's "Only N left". Newest day first; optionally one product, one pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- retailer (string, required): A retailer key, from list_retailers.
- retailerSku (string, optional): The retailer's own product id.
- pincode (string, optional): A six-digit pin code, or national.
- from (string, optional): First IST day, YYYY-MM-DD.
- to (string, optional): Last IST day, YYYY-MM-DD.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
read_file
Read a PDF, spreadsheet or document. Downloads one public file (http or https, at most 20 MiB; robots.txt honoured) and answers it as JSON: its kind from its own bytes (pdf, xlsx, pptx, docx, csv, text, json), title, and parts with references: one per PDF page, sheet (with its cell rows) or slide. A scanned PDF page has `hasText: false` and the file `needsOcr: true` (OCR is not run yet; images are refused). Old .xls, .doc and .ppt files are refused. Evidence: URL, time, SHA-256. Stores nothing. At most 30 files an hour for your organisation. Free. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- Free
- Who can call it
- API key or Sign in with Rewalto, permission tools:run
- Inputs
- url (string, required): The file URL.
read_site
Map or crawl a website. One public website from its start page. `mode: "map"` (default) lists its pages from its sitemaps and the start page’s links, reading only the start page. `mode: "crawl"` reads up to 20 pages breadth-first, each as clean Markdown with its status and evidence (URL, time, SHA-256). Bounds: maxPages or maxUrls, maxDepth, includePaths and excludePaths (path prefixes), subdomains off by default, other sites never, a crawl-trap guard, one time budget. Honours robots.txt. A partial answer says so (`complete: false`, `stoppedBy`); pages not delivered are in `failed`, URLs left out are counted in `skipped`. Read one page with fetch_page. Stores nothing. At most 10 calls an hour for your organisation. Free. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- Free
- Who can call it
- API key or Sign in with Rewalto, permission tools:run
- Inputs
- url (string, required): The start page URL.
- mode (string, optional): map (default) or crawl. One of: map, crawl.
- maxPages (integer, optional): Crawl: pages read, the start page included (default 10).
- maxUrls (integer, optional): Map: URLs listed (default 200).
- maxDepth (integer, optional): Crawl: clicks from the start page (default 1; 0 reads only the start page).
- includePaths (list of string, optional): Only paths starting with one of these, e.g. /blog/.
- excludePaths (list of string, optional): Never paths starting with one of these, e.g. /cart.
- allowSubdomains (boolean, optional): Also other hosts of the same site. Default false.
- useSitemap (boolean, optional): Read the site’s sitemaps. Default true.
search_apps
Google Play or App Store search (India). Rewalto's app store search results for one search in India, in store order: app id, name, developer, star rating and number of ratings, price. Charged per app delivered at the history rate. Every reading is kept as Rewalto history; the same request read in the last 24 hours answers from it (meta.reused). A new reading takes a minute or two: the first call answers data.status "pending" with meta.retryAfterSeconds and charges nothing; call again with the same arguments to collect it. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- store (string, required): google_play or app_store.
- q (string, required): The search, e.g. grocery delivery.
- depth (string, optional): Apps to read: 30 (default), 50 or 100.
search_brand_ads
Search a brand's ads. Finds a brand's ads on Meta (Facebook and Instagram), Google, LinkedIn, TikTok, YouTube creator sponsorships (only when `platforms` names youtube) and podcast mentions. A platform read in the last 7 days is answered from the database; the rest are pulled now in the background: poll get_brand_ad_search, then list_brand_ads with the brand. `domain` (the brand's own website) is needed for Google. `metaPages` names Meta page ids to read directly (Meta only, read now); their ads are filed under the brand only when the page's name leads with the brand's or it is a mapped identity. Every reading is kept as history. Free: never charged. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- Free; saves a record
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- brand (string, required): Brand name, e.g. Nykaa.
- domain (string, optional): The brand's own website, e.g. nykaa.com.
- platforms (list of string, optional): Default: every platform except youtube; name youtube to include it.
- metaPages (list of string, optional): Meta page ids (digits) to read directly, e.g. from an ad of the brand.
search_instagram_accounts
Instagram accounts search results (held). Approved internal clients only (Orcheo). Accounts (identity and flags) an Instagram accounts search returned for q, as Core holds them, in Instagram’s order, paged by nextCursor. meta.availability not_held until a pull ran: quote search_accounts with target.query. Free, never collects. Needs an API key of an approved client (C-047); any other caller gets not_found. Paging, provenance, availability, receipts and collector issues come back as structured fields.
- Credit cost
- Free
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- q (string, required): The search text, as quoted.
- limit (string, optional): Rows a page, 1 to 100 (default 25).
- cursor (string, optional): nextCursor from the previous page.
search_instagram_hashtags
Instagram hashtags search results (held). Approved internal clients only (Orcheo). Hashtags (with post counts) an Instagram hashtags search returned for q, as Core holds them, in Instagram’s order, paged by nextCursor. meta.availability not_held until a pull ran: quote search_hashtags with target.query. Free, never collects. Needs an API key of an approved client (C-047); any other caller gets not_found. Paging, provenance, availability, receipts and collector issues come back as structured fields.
- Credit cost
- Free
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- q (string, required): The search text, as quoted.
- limit (string, optional): Rows a page, 1 to 100 (default 25).
- cursor (string, optional): nextCursor from the previous page.
search_instagram_reels
Instagram reels search results (held). Approved internal clients only (Orcheo). Public reels an Instagram reels search returned for q, as Core holds them, in Instagram’s order, paged by nextCursor. meta.availability not_held until a pull ran: quote search_reels with target.query. Free, never collects. Needs an API key of an approved client (C-047); any other caller gets not_found. Paging, provenance, availability, receipts and collector issues come back as structured fields.
- Credit cost
- Free
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- q (string, required): The search text, as quoted.
- limit (string, optional): Rows a page, 1 to 100 (default 25).
- cursor (string, optional): nextCursor from the previous page.
search_listings
Search products by name. Retailer listings whose name, brand or retailer product id contain every word of q as the start of a word ("aashir atta" finds "Aashirvaad Atta"; Hindi words match as written), optionally one retailer, one exact brand, or listings read at one pin code in the last 30 days. Best match first: an exact retailer product id, then the words as a phrase in the name, then the rest, whole words before word starts ("atta" before "Attar"); when fewer than 10 match, likely misspellings follow ("ashirvad" finds "Aashirvaad"), those with the short typed words ("oil") first. Finding nothing costs nothing. Spends credits at the published read rate, with no quote; the answer’s `meta.credits` says what was charged and gives the receipt. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- q (string, required): The words: product name, brand or retailer product id. Up to 8 are used.
- retailer (string, optional): A retailer key, from list_retailers.
- brand (string, optional): Exact brand text, as in a listing’s brand.
- pincode (string, optional): A six-digit pin code: only listings read there in the last 30 days.
- limit (string, optional): At most this many rows (the API caps it).
- cursor (string, optional): The `next` cursor from the previous page.
search_places
Places on Google Maps or Tripadvisor for one search (India). Rewalto's places (restaurants, outlets, hotels) for one search in India; name the city in the search (biryani in bengaluru). In page order: place id, name, category, business address and location, star rating, number of ratings and ratings per star, price level and website. Charged per place delivered at the history rate. Every reading is kept as Rewalto history; the same request read in the last 24 hours answers from it (meta.reused). A new reading takes a minute or two: the first call answers data.status "pending" with meta.retryAfterSeconds and charges nothing; call again with the same arguments to collect it. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- May spend credits, only for data delivered
- Who can call it
- API key or Sign in with Rewalto, permission data:read
- Inputs
- source (string, required): google_maps or tripadvisor.
- q (string, required): The search, naming the city, e.g. biryani in bengaluru.
- depth (string, optional): Places to read: 20 (default), 50 or 100.
search_web
Search the web. Finds the web pages that best answer one query, tuned for India: each result has its rank, title, source URL and a short snippet. Read a result with fetch_page or extract_page. Results are live: nothing is stored. At most 20 searches an hour for your organisation. Free. Needs an API key; answers for the key’s own organisation only.
- Credit cost
- Free
- Who can call it
- API key or Sign in with Rewalto, permission tools:run
- Inputs
- query (string, required): What to search for.
- maxResults (integer, optional): At most this many results (default 5).
