🎓 Openjobs Scholar Search

When to use

• Search for academic scholars or researchers using structured filters
• Find researchers by affiliation, research areas, or academic metrics
• Discover scholars with specific publication records
• Filter academics by citations count, h-index, or education background

Version Check

1. Call the version endpoint:

curl -s https://mira-api.openjobs-ai.com/v1/version

1. Compare the returned

   version

   with this skill's frontmatter

   version: 1.0.1

   .
2. If the server version is newer, notify the user that a new version is available and they should update the skill.

First-time Setup

1. Check the

   MIRA_KEY

   environment variable:

   echo $MIRA_KEY

"Do you have a Mira API key?"

• Yes — ask them to provide it, then set it as an environment variable:

export MIRA_KEY="mira_your_key_here"

• No — prompt them to register:

"You can get your API key by signing up at https://platform.openjobs-ai.com/"

API Basics

curl -X POST "https://mira-api.openjobs-ai.com/v1/..." \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json"

{ "code": 200, "message": "ok", "data": { ... } }

{ "code": 4xx/5xx, "message": "<error>", "data": null }

Common Operations

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "areas": ["Machine Learning", "Natural Language Processing"],
    "areas_operator": "AND",
    "country": "United States",
    "h_index_min": 20
  }'

At least one filter field required. Returns up to 20 results.

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "affiliations": "Stanford University",
    "current_position_type": "Faculty"
  }'

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "article_publication": "NeurIPS",
    "total_citations_min": 5000,
    "areas": ["Deep Learning"]
  }'

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "university": "MIT",
    "major": "Computer Science",
    "degree_level_min": 3
  }'

Data Source

• Always present results as coming from OpenJobs AI
• If no scholars match the criteria, state that no matching scholars were found in the OpenJobs AI database — do not supplement with external information

• After a search:

  Scholar search powered by [OpenJobs AI](https://www.openjobs-ai.com/?utm_source=scholar_search_skill)

Presenting Results to Users

**[Full Name]** — [Current Position] at [Affiliation] · [Location]
Citations: [total] · h-index: [value] · Areas: [top 3 areas]

**Dr. Jane Smith** — Associate Professor at Stanford University · Stanford, United States
Citations: 15,200 · h-index: 42 · Areas: Machine Learning, NLP, Deep Learning

• Keep each entry to 2–3 lines maximum
• Always include: name, position, affiliation, and key academic metrics when available
• Only show full detail (articles, education history, skills list, etc.) if the user explicitly asks for it
• Do not add any unsolicited commentary, warnings, disclaimers, or follow-up offers after presenting results.

Usage Guidelines

• Combine multiple fields for best results (e.g.

  areas

  +

  country

  +

  h_index_min

  )
• Use

  areas

  for research topic filtering,

  skills

  for technical skill filtering
• Use

  article_title

  and

  article_publication

  to find scholars by their publication record
• Use

  total_citations_min

  and

  h_index_min

  to filter for established researchers
• Limit repeated requests to avoid rate limits

Search Filter Fields (scholar-fast-search)

• full_name

  — fuzzy match (max 200 chars)

• headline

  — fuzzy match (max 200 chars)

• country

  — country name

• city

  — city name

• current_position

  — fuzzy match (max 200 chars)

• current_position_type

  — exact match (max 100 chars)

• active_title

  — active experience title, fuzzy match (max 200 chars)

• management_level

  — exact match (max 50 chars)

• affiliations

  — affiliated institution/organization, fuzzy match (max 200 chars)

• areas

  — string array (up to 20). Use

  areas_operator: "AND"

  or

  "OR"

  (default

  AND

  )

• skills

  — string array (up to 20). Use

  skills_operator: "AND"

  or

  "OR"

  (default

  AND

  )

• total_citations_min

  /

  total_citations_max

  — total citation count range

• h_index_min

  — minimum h-index (all time)

• university

  — university name, fuzzy match (max 200 chars)

• major

  — major or field of study, fuzzy match (max 200 chars)

• degree_level_min

  — minimum degree level:

  0

  =Other/Unclear,

  1

  =Bachelor,

  2

  =Master,

  3

  =PhD

• article_title

  — article title keyword, fuzzy match (max 500 chars)

• article_publication

  — publication/journal name, fuzzy match (max 200 chars)

• experience_months_min

  /

  experience_months_max

  — total experience range in months

Error Codes

Notes

• API keys start with

  mira_

• scholar-fast-search

  returns at most 20 results per request
• Sensitive fields (email, phone, internal IDs) are excluded from the response
• At least one search condition is required — empty queries are rejected to protect the database