Web3.career Jobs API

Get Web3 job listings (JSON)

get

Fetch the latest Web3 job listings with optional filters for tag, country, remote status, and result count.

Response parsing note: The response body is a JSON array whose elements are a mix of strings and a nested array of job objects. Extract the jobs by finding the first array element within the root array.

Link attribution: When displaying results, you must link to jobs using the apply_url field with a follow link. See Terms of Use in the API description.

Authorizations

tokenstringRequired

API token obtained from web3.career/web3-jobs-api. Passed as a query parameter on every request.

Query parameters

tokenstringRequired

API authentication token obtained from web3.career/web3-jobs-api.

Example: your-api-token

tagstring · enumOptional

Filter by a single tag, skill, or category. Must be an exact slug from the supported tags list. Only one tag per request — multi-tag searches require separate API calls. Invalid tags silently return empty results.

Example: {"value":"solidity","summary":"Smart contract development"}Possible values:

countrystringOptional

Filter by country using a lowercase, hyphenated slug (e.g., united-states, united-kingdom, germany). Do not use country names, ISO codes, or abbreviations. Invalid slugs silently return empty results.

Example: {"value":"united-states","summary":"United States"}Pattern: ^[a-z]+(-[a-z]+)*$

remotestring · enumOptional

Set to true to return only remote positions. Omit entirely to return all jobs (remote and on-site). There is no false value — omission is "show all".

Possible values:

limitinteger · min: 1 · max: 100Optional

Number of job listings to return. Defaults to approximately 20 if omitted. There is no offset or cursor parameter — results are always the most recent listings.

Default: 20

show_descriptionstring · enumOptional

Set to false to exclude job descriptions from the response. Reduces payload size significantly. Descriptions may contain raw HTML when included.

Default: truePossible values:

Responses

200

Successful response. Returns a top-level JSON array containing mixed types. The actual job listings are in a nested array — find the first element in the root array that is itself an array.

application/json

Top-level response array containing mixed types. The structure is typically [string, string, Job[]] — two metadata strings followed by the jobs array. Extract jobs by finding the first element that is itself an array. In some cases the root array may directly contain job objects (fallback).

stringOptional

Metadata string (e.g., status or version identifier)

or

401

Unauthorized. The API token is invalid, expired, or missing. Verify the token parameter and obtain a new token from web3.career/web3-jobs-api if needed.

403

Forbidden. The token does not have sufficient permissions. Check your account settings at web3.career.

429

Rate limit exceeded. Too many requests in a short period. Implement exponential backoff with jitter and retry after a delay. Recommended: start at 1s, double each attempt, cap at 10s, add +/-20% jitter.

500

Internal server error. The web3.career API is experiencing issues. Retry with exponential backoff. These are typically transient.

get/v1

GET /api/v1?token=text HTTP/1.1
Host: web3.career
Accept: */*

[
  "ok",
  "v1",
  [
    {
      "id": "abc123",
      "title": "Senior Smart Contract Engineer",
      "company": "ExampleDAO",
      "location": "Remote",
      "remote": true,
      "description": "<p>We are looking for an experienced Solidity developer to build and audit smart contracts.</p>",
      "tags": [
        "solidity",
        "ethereum",
        "defi",
        "smart-contract"
      ],
      "apply_url": "https://web3.career/senior-smart-contract-engineer-exampledao?ref=abc",
      "url": "https://web3.career/senior-smart-contract-engineer-exampledao",
      "salary": "$150k - $200k",
      "postedAt": "2025-03-15"
    },
    {
      "id": "def456",
      "title": "Frontend Developer - DeFi Dashboard",
      "company": "YieldProtocol",
      "location": "New York, US",
      "remote": false,
      "description": "<p>Build user-facing interfaces for our DeFi products.</p>",
      "tags": [
        "react",
        "typescript",
        "defi",
        "front-end"
      ],
      "apply_url": "https://web3.career/frontend-developer-defi-dashboard-yieldprotocol?ref=xyz",
      "url": "https://web3.career/frontend-developer-defi-dashboard-yieldprotocol",
      "salary": "$120k - $160k",
      "postedAt": "2025-03-14"
    }
  ]
]