Microforge API
Researchers

List researchers

Returns paginated list of researchers with all related data

GET
/researchers

Authorization

Authorization

x-api-key<token>

In: header

Query Parameters

page?integer

Page number

Default1
per_page?integer

Items per page (max 100)

Default20
Rangevalue <= 100
hireability?string

Filter by hireability status

Value in"low" | "medium" | "high"
country?string

Filter by country

current_company?string

Filter by current company

current_role?string

Filter by current role

researcher_type?string

Filter by researcher type (professor, phd, employee, etc.)

min_h_index?integer

Minimum h-index

min_citations?integer

Minimum citations count

min_papers?integer

Minimum number of papers

min_final_score?number

Minimum final score

max_final_score?number

Maximum final score

Response Body

Successful response

TypeScript Definitions

Use the response body type in TypeScript.

data?array<object>
pagination?object

Unauthorized

TypeScript Definitions

Use the response body type in TypeScript.

error?string
message?string

Internal server error

TypeScript Definitions

Use the response body type in TypeScript.

error?string
message?string
curl -X GET "https://hiring-api.microforge.studio/v1/researchers?page=1&per_page=20&hireability=low&country=string&current_company=string&current_role=string&researcher_type=string&min_h_index=0&min_citations=0&min_papers=0&min_final_score=0&max_final_score=0"
fetch("https://hiring-api.microforge.studio/v1/researchers?page=1&per_page=20&hireability=low&country=string&current_company=string&current_role=string&researcher_type=string&min_h_index=0&min_citations=0&min_papers=0&min_final_score=0&max_final_score=0")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://hiring-api.microforge.studio/v1/researchers?page=1&per_page=20&hireability=low&country=string&current_company=string&current_role=string&researcher_type=string&min_h_index=0&min_citations=0&min_papers=0&min_final_score=0&max_final_score=0"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://hiring-api.microforge.studio/v1/researchers?page=1&per_page=20&hireability=low&country=string&current_company=string&current_role=string&researcher_type=string&min_h_index=0&min_citations=0&min_papers=0&min_final_score=0&max_final_score=0"

response = requests.request("GET", url)

print(response.text)
{
  "data": [
    {
      "researcher_slug": "string",
      "profile": {
        "homepage": "string",
        "email": "string",
        "university_affiliation": "string",
        "university_advisor": "string",
        "highest_degree": "string",
        "graduation_year": 0,
        "current_company": "string",
        "current_role": "string",
        "past_company_1": "string",
        "past_role_1": "string",
        "past_company_2": "string",
        "past_role_2": "string",
        "researcher_type": "string",
        "country": "string",
        "research_expertise": "string",
        "recognitions": "string",
        "research_categories": {},
        "category_summary": "string",
        "professional_experience": {},
        "years_of_experience": 0,
        "social_links": {
          "github": "string",
          "twitter": "string",
          "linkedin": "string",
          "google_scholar": "string"
        }
      },
      "metrics": {
        "h_index_all": 0,
        "h_index_2020": 0,
        "citations_all": 0,
        "citations_2020": 0,
        "i10_index_all": 0,
        "i10_index_2020": 0
      },
      "hireability": {
        "status": "low",
        "reasoning": "string"
      },
      "scores": {
        "final_score": 0,
        "entrepreneurship_score": 0,
        "collaborator_score": 0,
        "research_quality_score": 0,
        "github_score": 0,
        "research_impact_score": 0
      },
      "github": {},
      "collaborators": {},
      "website_changes": [
        {}
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "per_page": 0,
    "total": 0,
    "total_pages": 0
  }
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}