Microforge API
Researchers/Search

Search researchers

Search researchers by name and company

POST
/researchers/search

Authorization

Authorization

x-api-key<token>

In: header

Request Body

application/jsonRequired
querystring

Search query (searches name, current_company, past_company_1, past_company_2)

limit?integer

Maximum number of results (default 10, max 50)

Default10
Rangevalue <= 50

Response Body

Successful response

TypeScript Definitions

Use the response body type in TypeScript.

results?array<object>
count?integer

Bad request

TypeScript Definitions

Use the response body type in TypeScript.

error?string
message?string

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 POST "https://hiring-api.microforge.studio/v1/researchers/search" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Yann LeCun",
    "limit": 10
  }'
const body = JSON.stringify({
  "query": "Yann LeCun",
  "limit": 10
})

fetch("https://hiring-api.microforge.studio/v1/researchers/search", {
  body
})
package main

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

func main() {
  url := "https://hiring-api.microforge.studio/v1/researchers/search"
  body := strings.NewReader(`{
    "query": "Yann LeCun",
    "limit": 10
  }`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("Content-Type", "application/json")
  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/search"
body = {
  "query": "Yann LeCun",
  "limit": 10
}
response = requests.request("POST", url, json = body, headers = {
  "Content-Type": "application/json"
})

print(response.text)
{
  "results": [
    {
      "researcher_slug": "string",
      "name": "string",
      "current_company": "string",
      "current_role": "string",
      "past_company_1": "string",
      "past_role_1": "string",
      "past_company_2": "string",
      "past_role_2": "string"
    }
  ],
  "count": 0
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}