Rolli
Rolli API Documentation

Keyword Search

Create searches for keywords, hashtags, or usernames across multiple platforms.

POST /api/iq/keyword_search

Parameters

queryRequired — keyword-based search (supports AND/OR/NOT and parentheses)
start_dateOptional — default: one week before current date
end_dateOptional — default: current date
platformsOptional — array of platforms. Default: ["twitter","reddit","bluesky","youtube"]. Use ["linkedin"] separately if needed (LinkedIn only returns post data and can be slower).

Request Example

curl -X POST "https://rolli.ai/api/iq/keyword_search" \
  -H "X-ROLLI-TOKEN: your_token" \
  -H "X-ROLLI-USER-ID: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "AI election integrity",
  "start_date": "2025-07-01",
  "end_date": "2025-07-07",
  "platforms": [
    "twitter",
    "reddit",
    "bluesky",
    "youtube"
  ]
}'
    
fetch("https://rolli.ai/api/iq/keyword_search", {
  method: "POST",
  headers: {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"query":"AI election integrity","start_date":"2025-07-01","end_date":"2025-07-07","platforms":["twitter","reddit","bluesky","youtube"]})
})
  .then(res => res.json())
  .then(console.log);
    
require "net/http"
require "uri"
require "json"

uri = URI("https://rolli.ai/api/iq/keyword_search")
req = Net::HTTP::Post.new(uri)
req["X-ROLLI-TOKEN"] = "your_token"
req["X-ROLLI-USER-ID"] = "your_user_id"
req["Content-Type"] = "application/json"
req.body = {"query":"AI election integrity","start_date":"2025-07-01","end_date":"2025-07-07","platforms":["twitter","reddit","bluesky","youtube"]}.to_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/iq/keyword_search"
headers = {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
}

payload = {
  "query": "AI election integrity",
  "start_date": "2025-07-01",
  "end_date": "2025-07-07",
  "platforms": [
    "twitter",
    "reddit",
    "bluesky",
    "youtube"
  ]
}
response = requests.post(url, json=payload, headers=headers)

print(response.json())

Response Example

{
  "id": 1241,
  "query": "an example query",
  "created_at": "2023-10-01T12:00:00Z",
  "updated_at": "2023-10-01T12:00:00Z"
}

Intelligent analysis features (metrics, sentiment, coordination) are available for Twitter only.