How to fill the Search Seasonality Planner with DataForSEO
============================================================

Data source: DataForSEO Labs: Keyword Overview (search volume, monthly history, difficulty and intent for a list of keywords).
A helper command builds the input rows from saved API responses.

The seasonality command expands each keyword's 12-month history into 12 rows and calculates the annual total. Add base clicks and lead months yourself.

1. Request the data
   POST https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_overview/live
   Body:
   [
     {
       "keywords": [
         "your keyword 1",
         "your keyword 2"
       ],
       "location_code": 2840,
       "language_code": "en"
     }
   ]
   Auth: HTTP Basic with your DataForSEO API login and password. Keep credentials out of shared files.

2. Save the complete JSON response (not just the task ID) next to this folder, e.g. response.json.

3. Convert it to the input CSV (offline, Python 3.10+, no API call, no credentials):
   python3 Automation/dataforseo_import.py seasonality --input keyword-overview.json --output my-inputs.csv

4. Complete the columns DataForSEO can't supply:
   - Average-month clicks
   - Production lead months

5. Open the workbook, clear the demo rows in Workspace (lime input cells only), and paste the CSV values at cell A13.

Filled automatically: Keyword, Month number, Searches in month, 12-month searches
Source reference fills automatically with the task ID, endpoint, location, language, device and snapshot time, so every row is traceable.

Costs: estimate them first with the DataForSEO Cost Calculator (template 38). Live endpoints cost more than task_post/task_get.
Docs: https://docs.dataforseo.com/v3/