NextGenEnergyJobs.com

NextGen Energy Jobs API Documentation

Overview

The NextGen Energy Jobs API provides programmatic access to renewable energy job listings. The API is RESTful and returns data in JSON format.

Base URL

https://nextgenenergyjobs.com/api/v1

Authentication

Currently, the API is rate-limited but does not require authentication. Rate limit: 100 requests per minute per IP.

Endpoints

GET /jobs

Retrieve job listings with optional filters.

Query Parameters

  • industry (optional): Filter by industry
  • location (optional): Filter by city
  • company (optional): Filter by company name
  • type (optional): Filter by job type
  • page (optional): Page number for pagination (default: 1)
  • limit (optional): Results per page (default: 10)
  • minSalary (optional): Minimum salary filter
  • maxSalary (optional): Maximum salary filter
  • search (optional): Search term for jobs

Example Request

GET /api/v1/jobs?industry=Solar+Energy&location=San+Francisco&page=1&limit=10

Example Response

{
  "data": [
    {
      "id": "123",
      "basics": {
        "title": "Solar Installation Manager",
        "company": "SolarCo",
        "industry": {
          "primary": "Solar Energy",
          "focus": "Residential Installation"
        }
      }
    }
  ],
  "pagination": {
    "total": 45,
    "pages": 5,
    "current_page": 1,
    "per_page": 10
  }
}

Rate Limiting

The API is limited to 100 requests per minute per IP address. Rate limit information is included in the response headers:

  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Remaining requests in the current window
  • X-RateLimit-Reset: Time when the rate limit resets

Support

For API support or to report issues, please contact api@nextgenenergyjobs.com