DevRel Directory

Search the devrel.directory listings of DevRel tools, communities, newsletters, podcasts, and agencies. Filter by a free-text query (matched against name, description, and tags) and/or an exact category. Each result includes the external url and a canonicalUrl to the listing's page on devrel.directory.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Case-insensitive substring matched against name, description, and tags.",
      "type": "string"
    },
    "category": {
      "description": "Exact listing category to filter to.",
      "type": "string",
      "enum": [
        "tool",
        "community",
        "newsletter",
        "podcast",
        "agency"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the full detail for one directory listing by its slug, including longer details when present, the source repository URL and its maintenance signals where the listing has one (bucketed star count, last commit and last release month, whether GitHub reports the repository archived, and the date all of those were checked), the slugs of similar listings, curated alternatives and complements (hand-picked substitutes and stack pairings, as slug + name), and any open DevRel jobs or upcoming events cross-linked to the same company. Returns an error for an unknown slug.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The listing slug, as returned by search_directory (e.g. 'answer-overflow')."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List currently open DevRel job postings. Filter by a free-text query (matched against title, company, location, and tags), a remote flag, an employment type, a seniority level, and/or a minimum salary - the same filters, with the same semantics, as the site's jobs page. Salary fields are passed through exactly as the posting states them. Each result includes the external posting url and a canonicalUrl to the job on devrel.directory.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Case-insensitive substring matched against title, company, location, and tags.",
      "type": "string"
    },
    "remote": {
      "description": "When true, only remote roles; when false, only non-remote roles.",
      "type": "boolean"
    },
    "employmentType": {
      "description": "Filter to one employment type (postings that omit it are treated as full-time).",
      "type": "string",
      "enum": [
        "full-time",
        "part-time",
        "contract",
        "internship"
      ]
    },
    "level": {
      "description": "Filter to one seniority bucket, derived from the job title the way the site derives it (management titles outrank IC prefixes).",
      "type": "string",
      "enum": [
        "junior",
        "mid",
        "senior",
        "staff",
        "leadership"
      ]
    },
    "salaryFloor": {
      "description": "Only roles whose stated yearly pay could reach this amount (compared against the highest stated bound, in the posting's own currency; roles with no stated pay never qualify).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List DevRel events and conferences with their call-for-papers deadlines. Defaults to upcoming events only; set upcomingOnly to false to include past events, or cfpOpenOnly to true to keep only events whose CFP is still open. Each result includes the external event url and a canonicalUrl to the events page on devrel.directory.

{
  "type": "object",
  "properties": {
    "upcomingOnly": {
      "description": "Default true; set false to include events that have already started or ended.",
      "type": "boolean"
    },
    "cfpOpenOnly": {
      "description": "When true, only events whose call for papers is still accepting submissions.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Aggregate statistics across devrel.directory in one call: listing counts by category; active job count, distinct hiring companies, the workplace mix (remote/hybrid/onsite counts), the share of roles that are remote or remote-friendly (the site's own classification, which also reads remote-prefixed locations), and salary min/median/max computed ONLY over roles stating USD pay (currencies are never blended); upcoming event count, open CFPs, and CFPs closing within 30 days. Every salary figure carries n, the number of disclosing roles - always cite n alongside any salary figure, and treat a small n as a weak signal; smallSample is true when that sample is below the threshold the site itself requires before quoting a headline salary, so qualify the figures rather than repeating them flat. Each section carries a canonicalUrl to the devrel.directory page behind it, and methodologyUrl links the page stating how the salary figures are computed.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search the devrel.directory unified index of documentation guides, blog posts, directory listings, jobs, and events (including which have an open call for papers). Returns matching results with absolute devrel.directory URLs; event results deep-link to the specific event on the events page.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}