Developer Integrations

Quick integration guides and ready-to-run code snippets in popular programming languages.

🚀 Getting Started
  • Retrieve API Credentials

    Request an API token (with sk- prefix) from the AI Platform team.

  • Set Authorization Header

    Send all requests containing the token in the Authorization: Bearer YOUR_API_KEY header.

  • Send JSON Payload

    Use POST requests with standard JSON request bodies to get real-time matching.

curl -X POST 'https://dev.mdpi.ai/api/v1/ror/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "affiliations": [
      "Massachusetts Institute of Technology"
    ],
    "include_deprecated_ror_ids": false
  }'
import requests

url = "https://dev.mdpi.ai/api/v1/ror/search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "affiliations": [
        "Massachusetts Institute of Technology"
    ],
    "include_deprecated_ror_ids": False
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)
const url = 'https://dev.mdpi.ai/api/v1/ror/search';
const payload = {
  affiliations: ['Massachusetts Institute of Technology'],
  include_deprecated_ror_ids: false
};

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});

const data = await response.json();
console.log(data);
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://dev.mdpi.ai/api/v1/ror/search"
	payload := map[string]interface{}{
		"affiliations": []string{"Massachusetts Institute of Technology"},
		"include_deprecated_ror_ids": false,
	}
	
	jsonPayload, _ := json.Marshal(payload)
	req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonPayload))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
<?php

$url = "https://dev.mdpi.ai/api/v1/ror/search";
$headers = [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json"
];
$payload = [
    "affiliations" => [
        "Massachusetts Institute of Technology"
    ],
    "include_deprecated_ror_ids" => false
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var url = "https://dev.mdpi.ai/api/v1/ror/search";
        var payload = new
        {
            affiliations = new[] { "Massachusetts Institute of Technology" },
            include_deprecated_ror_ids = false
        };

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");

        var json = JsonSerializer.Serialize(payload);
        var content = new StringContent(json, Encoding.UTF8, "application/json");

        var response = await client.PostAsync(url, content);
        var responseString = await response.Content.ReadAsStringAsync();
        Console.WriteLine(responseString);
    }
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://dev.mdpi.ai/api/v1/ror/search";
        String payload = """
            {
                "affiliations": [
                    "Massachusetts Institute of Technology"
                ],
                "include_deprecated_ror_ids": false
            }
            """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer YOUR_API_KEY")
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(payload))
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}