Search Details

Retrieve expert search results by ID.

GET /api/search/{search_id}

Parameters

FieldDescription
search_idSearch 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 NameDescription
idThe search ID.
queryThe search query.
created_atTimestamp when the search was created.
updated_atTimestamp when the search was last updated.
statusThe search status (e.g. "running", "completed").
search_urlDirect link to view the search results on Rolli (authentication required).
expert_resultsThe search results array; populated only when status is completed.

Expert Result Fields

Field NameDescription
expert_nameThe expert name.
expert_usernameThe expert's username on Rolli.
locationThe expert’s location.
expert_urlThe expert’s public profile URL on Rolli.
languagesThe languages spoken by the expert.
emailThe expert’s email contact.
phone_numberThe expert’s phone number.
professional_titleThe expert’s professional title and organization.
profile_image_urlLink to the expert’s profile image.
keywordsArray of keywords describing the expert’s areas of expertise.
ai_summaryAI-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."
      }
    ]
  }