{
  "name": "SEO Dataset Starter Field Guide",
  "updated_at": "2026-11-14",
  "sample_data_notice": "Every sample row is fictional. No warehouse, customer, contact, or private search data is included.",
  "sources": [
    {
      "name": "Google Search Console Performance report",
      "url": "https://support.google.com/webmasters/answer/7576553"
    },
    {
      "name": "Microsoft Excel data organization guidance",
      "url": "https://support.microsoft.com/en-us/excel/guidelines-for-organizing-and-formatting-data-on-a-worksheet"
    },
    {
      "name": "AI Trade Skills Dataset SEO project",
      "url": "https://www.aitradeskills.com/programs/dataset-seo/"
    }
  ],
  "fields": [
    {
      "field": "period",
      "used_on": "All source tabs",
      "meaning": "Labels the equal comparison side.",
      "format_or_rule": "Use only Prior or Current."
    },
    {
      "field": "start_date",
      "used_on": "All source tabs",
      "meaning": "First complete day included in the export.",
      "format_or_rule": "Real date in yyyy-mm-dd format."
    },
    {
      "field": "end_date",
      "used_on": "All source tabs",
      "meaning": "Last complete day included in the export.",
      "format_or_rule": "Real date in yyyy-mm-dd format."
    },
    {
      "field": "query",
      "used_on": "Queries",
      "meaning": "Words reported for a Google Search result.",
      "format_or_rule": "Keep the exported text."
    },
    {
      "field": "page",
      "used_on": "Pages",
      "meaning": "Landing page reported for the result.",
      "format_or_rule": "Keep the full canonical URL."
    },
    {
      "field": "dimension_type",
      "used_on": "Devices and Countries",
      "meaning": "States whether a row came from a device or country export.",
      "format_or_rule": "Use Device or Country."
    },
    {
      "field": "dimension",
      "used_on": "Devices and Countries",
      "meaning": "The reported device or country label.",
      "format_or_rule": "Keep the exported label."
    },
    {
      "field": "clicks",
      "used_on": "All source tabs",
      "meaning": "Visits from Google Search.",
      "format_or_rule": "Whole number from the export."
    },
    {
      "field": "impressions",
      "used_on": "All source tabs",
      "meaning": "Times a result was shown in Google Search.",
      "format_or_rule": "Whole number. Do not add unlike dimension exports together."
    },
    {
      "field": "ctr",
      "used_on": "All source tabs",
      "meaning": "Clicks divided by impressions.",
      "format_or_rule": "Formula: clicks / impressions."
    },
    {
      "field": "position",
      "used_on": "All source tabs",
      "meaning": "Average highest position reported for the row.",
      "format_or_rule": "Keep the exported decimal."
    },
    {
      "field": "weighted_position_points",
      "used_on": "Queries",
      "meaning": "Position multiplied by impressions for a weighted average.",
      "format_or_rule": "Formula: position * impressions."
    }
  ]
}
