When JSON is the better format

Choose JSON when a script, database, notebook, data pipeline, or analysis tool benefits from explicit types and nested structures. CSV is easier for most spreadsheets; JSON is clearer when you need arrays such as image links, distinguish missing values from empty text, or inspect job-level metadata separately from review records.

Export steps

  1. Open an Amazon product page, reviews page, or enter an ASIN manually.
  2. Select JSON in the INCIO Reviews popup.
  3. Choose the requested count, rating filter, and sort option.
  4. Start the user-initiated export and wait for collection to finish or stop safely.
  5. Open the downloaded file in a code editor or import it into your analysis environment.

How the JSON export is organized

Schema version 1.2 places the schema version at the top level, keeps job metadata in a meta object, preserves warnings and errors, and stores review records in a reviews array. Review records can include text, rating, author display name, date, verified status, helpful count, variation, identifiers, URLs, image-link arrays, marketplace context, and source page number.

Metadata records the request mode, source URL when available, requested, available, target, and collected counts, the 100-review extension limit, processed pages, selected filters, completion reason, dataset completeness, and timestamps. A downstream workflow should inspect those fields before assuming the dataset is complete.

Quality checks before analysis

  • Confirm export_status and completion_reason.
  • Check source_dataset_completeness before generalizing.
  • Review warning and error codes instead of silently ignoring them.
  • Deduplicate by review ID only when the ID is present.
  • Keep nulls as unknown values rather than converting them to false facts.
  • Use source page number and review URL when auditing a finding.

Local export and responsible handling

The JSON file is created locally and is not sent to INCIO. It may contain public reviewer display names, review text, identifiers, and URLs. Limit unnecessary sharing, remove fields you do not need, follow applicable law and platform terms, and review the privacy terms of any service to which you upload the file.