Skip to main content
Get up and running with custom geographical data exports in just a few minutes. This guide walks you through account setup, understanding the credit system, and creating your first export.

​
Step 1: Create Your Account

Choose your preferred sign-up method to get started with 5 free trial credits.
  • GitHub Sign-Up
  • Email Sign-Up
Quick One-Click Registration
  1. Visit CSC Export Tool
  2. Click “Sign up with GitHub”
  3. Authorize the application
  4. You’re ready to go!
Instant Setup: Your account is created immediately with 5 free credits added automatically.

​
Step 2: Understanding the Credit System

Credits are the currency used to generate exports. Here’s everything you need to know:

​
How Credits Work

Dataset Costs

Per Dataset Pricing
  • Countries: 1 credit
  • States: 2 credits
  • Cities: 3 credits

Format Costs

Additional Format Fees
  • JSON: Free (0 credits)
  • CSV: +1 credit
  • XML: +2 credits
  • YAML: +2 credits
  • SQL: +3 credits

​
Credit Calculation Examples

Scenario: Countries data in JSON format
  • Countries dataset: 1 credit
  • JSON format: +0 credits
  • Total: 1 credit
Perfect for basic country dropdowns in web forms.
Scenario: Countries with states data in JSON format
  • Countries dataset: 1 credit
  • States dataset: 2 credits
  • JSON format: +0 credits
  • Total: 3 credits
Ideal for multi-level location selection in checkout forms.
Scenario: All datasets in CSV format for Excel analysis
  • Countries dataset: 1 credit
  • States dataset: 2 credits
  • Cities dataset: 3 credits
  • CSV format: +1 credit
  • Total: 7 credits
Great for comprehensive data analysis and visualization.
Scenario: Countries data ready for database import
  • Countries dataset: 1 credit
  • SQL format: +3 credits
  • Total: 4 credits
Perfect for populating database tables with geographical data.

​
Free Trial Credits

Every new user receives 5 free credits to test the system and explore different export options before purchasing additional credits.
What you can do with your 5 free credits:
  • Basic Testing: Countries (1 credit) + States (2 credits) = 3 credits, with 2 remaining for format upgrades
  • Complete Dataset: Cities in JSON format (3 credits) + 2 credits for additional experiments
  • Format Comparison: Countries in CSV (2 credits) + Countries in XML (3 credits) = 5 credits perfect fit
  • Database Ready: Countries in SQL format (4 credits) with 1 credit remaining
Need more credits? The Starter Pack (6 credits for $2.99) gives you enough for all three datasets in JSON format!

​
Step 3: Your First Export

Let’s create a simple countries export to get familiar with the process.
1

Select Dataset

  1. Log into your account
  2. Click “Create New Export”
  3. Under “Datasets,” select Countries
  4. You’ll see “1 credit” cost indicator
Dataset selection interface showing Countries option selected
2

Choose Fields

Select the specific data fields you need:Recommended for first export:
  • name - Country name
  • iso2 - 2-letter country code
  • currency - Currency code
  • phone_code - International dialing code
Start Simple: Choose 4-5 essential fields for your first export to see how the system works.
3

Select Format

Choose JSON for your first export since it’s free and works great for web applications.
{
  "countries": [
    {
      "name": "United States",
      "iso2": "US",
      "currency": "USD", 
      "phone_code": "1"
    },
    {
      "name": "Canada",
      "iso2": "CA",
      "currency": "CAD",
      "phone_code": "1"
    }
  ]
}
4

Preview & Confirm

  1. Click “Preview Export” to see a sample of your data
  2. Review the credit cost (should show “1 credit”)
  3. If satisfied, click “Create Export”
Credit Deduction: Credits are deducted only when you click “Create Export,” not during preview.
5

Download Your Data

  1. Wait for processing (usually 10-30 seconds)
  2. Click “Download ZIP” when ready
  3. Extract the ZIP file to access your JSON data
Success! You’ve created your first custom geographical data export.

​
Managing Your Credits

​
Checking Your Balance

  • Dashboard View
  • Account Page
Your credit balance is prominently displayed on the main dashboard:
  • Current credits remaining
  • Recent transaction history
  • Usage patterns and recommendations

​
When You Need More Credits

Individual Credits

$1.00 per credit
  • Buy exactly what you need
  • Perfect for one-time exports
  • No minimum purchase

Starter Pack

6 Credits - $2.99
  • 50% savings per credit
  • Great for small projects
  • Test all features

Basic Pack

10 Credits - $4.99
  • Most Popular choice
  • Perfect for regular usage
  • 50% savings per credit

Standard Pack

25 Credits - $9.99
  • Ideal for active development
  • 60% savings per credit
  • Covers most project needs

Premium Pack

60 Credits - $19.99
  • Best Value - 67% savings
  • Perfect for large projects
  • Maximum bulk discount
Smart Savings: Credits never expire, so larger packages offer better value. The Premium Pack saves you 67% compared to individual credit purchases!

​
Purchasing Credits

1

Select Package

Choose the credit package that fits your needs from the pricing page.
2

Secure Payment

  • Powered by Dodo Payments
  • Major credit cards accepted
  • Secure, encrypted transactions
  • Instant credit delivery
3

Confirmation

  • Credits added to your account immediately
  • Email receipt sent automatically
  • Ready to use for exports instantly

​
Account Dashboard Overview

Your dashboard provides everything you need to manage exports and credits:

​
Main Features

  • View all previous exports
  • Re-download files for 30 days
  • See credit costs for each export
  • Track usage patterns over time
  • Current balance display
  • Purchase history with receipts
  • Usage analytics and recommendations
  • No expiration dates on credits
  • Personal information management
  • Email notification preferences
  • API access (coming soon)
  • Security settings and login methods

​
Next Steps

Now that you’ve got the basics down, explore these advanced features:

Explore Use Cases

See real-world examples for e-commerce, mobile apps, and analytics

Learn Export Formats

Deep dive into JSON, CSV, XML, YAML, and SQL format options

​
Common Getting Started Questions

Most users complete their first export within 2-3 minutes of signing up. The process is designed to be intuitive and fast.
Use the preview feature before confirming to see exactly what you’ll get. Preview is free and doesn’t use credits.
You’ll need to create a new export for different fields or formats. However, you can re-download the same export for 30 days.
Simply purchase more credits - they’re added instantly to your account and never expire.
Ready to create more exports? Check out our use cases guide for inspiration and practical examples.