Search Details
Retrieve expert search results by ID.
GET /api/search/{search_id}
Parameters
| Field | Description |
|---|---|
| search_id | Search ID |
Request Example
curl -X GET "https://rolli.ai/api/search/1241" \
-H "X-ROLLI-TOKEN: your_token" \
-H "X-ROLLI-USER-ID: your_user_id" \
-H "Content-Type: application/json"
fetch("https://rolli.ai/api/search/1241", {
method: "GET",
headers: {
"X-ROLLI-TOKEN": "your_token",
"X-ROLLI-USER-ID": "your_user_id",
"Content-Type": "application/json"
},
})
.then(res => res.json())
.then(console.log);
require "net/http"
require "uri"
require "json"
uri = URI("https://rolli.ai/api/search/1241")
req = Net::HTTP::Get.new(uri)
req["X-ROLLI-TOKEN"] = "your_token"
req["X-ROLLI-USER-ID"] = "your_user_id"
req["Content-Type"] = "application/json"
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(req)
end
puts res.body
import requests
import json
url = "https://rolli.ai/api/search/1241"
headers = {
"X-ROLLI-TOKEN": "your_token",
"X-ROLLI-USER-ID": "your_user_id",
"Content-Type": "application/json"
}response = requests.get(url, headers=headers)
print(response.json())
Response Fields
| Field Name | Description |
|---|---|
| id | The search ID. |
| query | The search query. |
| created_at | Timestamp when the search was created. |
| updated_at | Timestamp when the search was last updated. |
| status | The search status (e.g. "running", "completed"). |
| search_url | Direct link to view the search results on Rolli (authentication required). |
| expert_results | The search results array; populated only when status is completed. |
Expert Result Fields
| Field Name | Description |
|---|---|
| expert_name | The expert name. |
| expert_username | The expert's username on Rolli. |
| location | The expert’s location. |
| expert_url | The expert’s public profile URL on Rolli. |
| languages | The languages spoken by the expert. |
| The expert’s email contact. | |
| phone_number | The expert’s phone number. |
| professional_title | The expert’s professional title and organization. |
| profile_image_url | Link to the expert’s profile image. |
| keywords | Array of keywords describing the expert’s areas of expertise. |
| ai_summary | AI-generated explanation of why the expert matches the query. |
Example Response
{
"id": 1241,
"query": "an example query",
"created_at": "2023-10-01T12:00:00Z",
"updated_at": "2023-10-01T12:00:00Z",
"status": "completed",
"search_url": "https://rolli.ai/search/1241",
"expert_results": [
{
"expert_name": "John Doe",
"expert_username": "johndoe",
"location": "Washington, DC • United States",
"expert_url": "https://rolli.ai/johndoe",
"languages": "English, Spanish",
"email": "john.doe@example.com",
"phone_number": "+1 234 567 8900",
"professional_title": "Senior Software Engineer of SomeTech Company",
"profile_image_url": "https://rolli.ai/images/johndoe.jpg",
"keywords": [
"software",
"web development",
"programming",
"engineering"
],
"ai_summary": "John's expertise in international economics and trade makes him ideal for discussing the global and domestic implications of GDP shifts."
}
]
}