Mentions

Export mentions

Export up to 50,000 mentions matching the given view and filters. Body shape matches POST /api/v2/mentions (v1-compatible) plus a format selector, an optional total-row limit cap, and an optional author pivot (one author’s mentions on a single source). Returns a downloadable file. Pass format: "csv" for a CSV or omit / "json" for a JSON file.

Export-specific rate limits (on top of the generic hourly cap): 5 exports per hour and 2 concurrent exports per organization — each export fans out into many backing queries, so it is budgeted separately from ordinary requests. Exceeding either returns 429 (code: "RATE_LIMITED"; the hourly-cap variant carries details.retryAfterSeconds). Exports are for ad-hoc extraction — to continuously sync mentions, poll POST /api/v2/mentions with a startDate cursor instead of re-exporting the workspace on a schedule.

POST

api

mentions

export

Export mentions

curl --request POST \
  --url https://app.octolens.com/api/v2/mentions/export \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "view": 123,
  "filters": {
    "source": [
      "reddit"
    ],
    "sentiment": [],
    "keyword": [
      0
    ],
    "language": [],
    "tag": [
      "<string>"
    ],
    "relevance": [
      "<string>"
    ],
    "reviewRating": [
      3
    ],
    "postType": [],
    "engagement": [
      {
        "source": "twitter",
        "metric": "likes",
        "value": 100,
        "operator": ">="
      }
    ],
    "!source": [
      "reddit"
    ],
    "!sentiment": [],
    "!keyword": [
      0
    ],
    "!language": [],
    "!tag": [
      "<string>"
    ],
    "!relevance": [
      "<string>"
    ],
    "!reviewRating": [
      3
    ],
    "!postType": [],
    "minXFollowers": 4503599627370495,
    "maxXFollowers": 4503599627370495,
    "startDate": "<string>",
    "endDate": "<string>"
  },
  "includeAll": false,
  "includeEngagementMetrics": true,
  "includeRelevantOnly": true,
  "cursor": "<string>",
  "search": "<string>",
  "format": "csv",
  "limit": 25000,
  "author": "<string>"
}
'

import requests

url = "https://app.octolens.com/api/v2/mentions/export"

payload = {
    "view": 123,
    "filters": {
        "source": ["reddit"],
        "sentiment": [],
        "keyword": [0],
        "language": [],
        "tag": ["<string>"],
        "relevance": ["<string>"],
        "reviewRating": [3],
        "postType": [],
        "engagement": [
            {
                "source": "twitter",
                "metric": "likes",
                "value": 100,
                "operator": ">="
            }
        ],
        "!source": ["reddit"],
        "!sentiment": [],
        "!keyword": [0],
        "!language": [],
        "!tag": ["<string>"],
        "!relevance": ["<string>"],
        "!reviewRating": [3],
        "!postType": [],
        "minXFollowers": 4503599627370495,
        "maxXFollowers": 4503599627370495,
        "startDate": "<string>",
        "endDate": "<string>"
    },
    "includeAll": False,
    "includeEngagementMetrics": True,
    "includeRelevantOnly": True,
    "cursor": "<string>",
    "search": "<string>",
    "format": "csv",
    "limit": 25000,
    "author": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    view: 123,
    filters: {
      source: ['reddit'],
      sentiment: [],
      keyword: [0],
      language: [],
      tag: ['<string>'],
      relevance: ['<string>'],
      reviewRating: [3],
      postType: [],
      engagement: [{source: 'twitter', metric: 'likes', value: 100, operator: '>='}],
      '!source': ['reddit'],
      '!sentiment': [],
      '!keyword': [0],
      '!language': [],
      '!tag': ['<string>'],
      '!relevance': ['<string>'],
      '!reviewRating': [3],
      '!postType': [],
      minXFollowers: 4503599627370495,
      maxXFollowers: 4503599627370495,
      startDate: '<string>',
      endDate: '<string>'
    },
    includeAll: false,
    includeEngagementMetrics: true,
    includeRelevantOnly: true,
    cursor: '<string>',
    search: '<string>',
    format: 'csv',
    limit: 25000,
    author: '<string>'
  })
};

fetch('https://app.octolens.com/api/v2/mentions/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.octolens.com/api/v2/mentions/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'view' => 123,
    'filters' => [
        'source' => [
                'reddit'
        ],
        'sentiment' => [
                
        ],
        'keyword' => [
                0
        ],
        'language' => [
                
        ],
        'tag' => [
                '<string>'
        ],
        'relevance' => [
                '<string>'
        ],
        'reviewRating' => [
                3
        ],
        'postType' => [
                
        ],
        'engagement' => [
                [
                                'source' => 'twitter',
                                'metric' => 'likes',
                                'value' => 100,
                                'operator' => '>='
                ]
        ],
        '!source' => [
                'reddit'
        ],
        '!sentiment' => [
                
        ],
        '!keyword' => [
                0
        ],
        '!language' => [
                
        ],
        '!tag' => [
                '<string>'
        ],
        '!relevance' => [
                '<string>'
        ],
        '!reviewRating' => [
                3
        ],
        '!postType' => [
                
        ],
        'minXFollowers' => 4503599627370495,
        'maxXFollowers' => 4503599627370495,
        'startDate' => '<string>',
        'endDate' => '<string>'
    ],
    'includeAll' => false,
    'includeEngagementMetrics' => true,
    'includeRelevantOnly' => true,
    'cursor' => '<string>',
    'search' => '<string>',
    'format' => 'csv',
    'limit' => 25000,
    'author' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://app.octolens.com/api/v2/mentions/export"

	payload := strings.NewReader("{\n  \"view\": 123,\n  \"filters\": {\n    \"source\": [\n      \"reddit\"\n    ],\n    \"sentiment\": [],\n    \"keyword\": [\n      0\n    ],\n    \"language\": [],\n    \"tag\": [\n      \"<string>\"\n    ],\n    \"relevance\": [\n      \"<string>\"\n    ],\n    \"reviewRating\": [\n      3\n    ],\n    \"postType\": [],\n    \"engagement\": [\n      {\n        \"source\": \"twitter\",\n        \"metric\": \"likes\",\n        \"value\": 100,\n        \"operator\": \">=\"\n      }\n    ],\n    \"!source\": [\n      \"reddit\"\n    ],\n    \"!sentiment\": [],\n    \"!keyword\": [\n      0\n    ],\n    \"!language\": [],\n    \"!tag\": [\n      \"<string>\"\n    ],\n    \"!relevance\": [\n      \"<string>\"\n    ],\n    \"!reviewRating\": [\n      3\n    ],\n    \"!postType\": [],\n    \"minXFollowers\": 4503599627370495,\n    \"maxXFollowers\": 4503599627370495,\n    \"startDate\": \"<string>\",\n    \"endDate\": \"<string>\"\n  },\n  \"includeAll\": false,\n  \"includeEngagementMetrics\": true,\n  \"includeRelevantOnly\": true,\n  \"cursor\": \"<string>\",\n  \"search\": \"<string>\",\n  \"format\": \"csv\",\n  \"limit\": 25000,\n  \"author\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.octolens.com/api/v2/mentions/export")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"view\": 123,\n  \"filters\": {\n    \"source\": [\n      \"reddit\"\n    ],\n    \"sentiment\": [],\n    \"keyword\": [\n      0\n    ],\n    \"language\": [],\n    \"tag\": [\n      \"<string>\"\n    ],\n    \"relevance\": [\n      \"<string>\"\n    ],\n    \"reviewRating\": [\n      3\n    ],\n    \"postType\": [],\n    \"engagement\": [\n      {\n        \"source\": \"twitter\",\n        \"metric\": \"likes\",\n        \"value\": 100,\n        \"operator\": \">=\"\n      }\n    ],\n    \"!source\": [\n      \"reddit\"\n    ],\n    \"!sentiment\": [],\n    \"!keyword\": [\n      0\n    ],\n    \"!language\": [],\n    \"!tag\": [\n      \"<string>\"\n    ],\n    \"!relevance\": [\n      \"<string>\"\n    ],\n    \"!reviewRating\": [\n      3\n    ],\n    \"!postType\": [],\n    \"minXFollowers\": 4503599627370495,\n    \"maxXFollowers\": 4503599627370495,\n    \"startDate\": \"<string>\",\n    \"endDate\": \"<string>\"\n  },\n  \"includeAll\": false,\n  \"includeEngagementMetrics\": true,\n  \"includeRelevantOnly\": true,\n  \"cursor\": \"<string>\",\n  \"search\": \"<string>\",\n  \"format\": \"csv\",\n  \"limit\": 25000,\n  \"author\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.octolens.com/api/v2/mentions/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"view\": 123,\n  \"filters\": {\n    \"source\": [\n      \"reddit\"\n    ],\n    \"sentiment\": [],\n    \"keyword\": [\n      0\n    ],\n    \"language\": [],\n    \"tag\": [\n      \"<string>\"\n    ],\n    \"relevance\": [\n      \"<string>\"\n    ],\n    \"reviewRating\": [\n      3\n    ],\n    \"postType\": [],\n    \"engagement\": [\n      {\n        \"source\": \"twitter\",\n        \"metric\": \"likes\",\n        \"value\": 100,\n        \"operator\": \">=\"\n      }\n    ],\n    \"!source\": [\n      \"reddit\"\n    ],\n    \"!sentiment\": [],\n    \"!keyword\": [\n      0\n    ],\n    \"!language\": [],\n    \"!tag\": [\n      \"<string>\"\n    ],\n    \"!relevance\": [\n      \"<string>\"\n    ],\n    \"!reviewRating\": [\n      3\n    ],\n    \"!postType\": [],\n    \"minXFollowers\": 4503599627370495,\n    \"maxXFollowers\": 4503599627370495,\n    \"startDate\": \"<string>\",\n    \"endDate\": \"<string>\"\n  },\n  \"includeAll\": false,\n  \"includeEngagementMetrics\": true,\n  \"includeRelevantOnly\": true,\n  \"cursor\": \"<string>\",\n  \"search\": \"<string>\",\n  \"format\": \"csv\",\n  \"limit\": 25000,\n  \"author\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": 0,
      "sourceId": "reddit_t3_1abc234",
      "url": "https://reddit.com/r/example/comments/abc123/...",
      "title": "<string>",
      "body": "<string>",
      "source": "reddit",
      "timestamp": "2026-05-06 13:35:37.000",
      "author": "jane.doe",
      "authorName": "<string>",
      "authorAvatar": "<string>",
      "authorUrl": "<string>",
      "authorFollowers": 0,
      "relevance": "relevant",
      "relevanceComment": "<string>",
      "sentiment": "Neutral",
      "language": "english",
      "tags": [
        "competitor_mention",
        "pricing"
      ],
      "keywords": [
        {
          "id": 42,
          "keyword": "social listening"
        }
      ],
      "engaged": true,
      "isReply": true,
      "review": {
        "rating": 1,
        "ratingMax": 123,
        "verified": true,
        "response": "<string>",
        "responseAt": "<string>",
        "targetName": "<string>"
      },
      "relevanceScore": 123,
      "feedbackRelevant": 123,
      "imageUrl": "<string>",
      "keywordId": 123,
      "engagementMetrics": {
        "likes": 120,
        "replies": 8,
        "views": 4200
      },
      "engagementObservedAt": "<string>"
    }
  ],
  "total": 0
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

Authorizations

Authorization

string

header

required

Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>. Keys carry a scope — read, write (implies read) or admin (implies write) — chosen when the key is minted. Each operation's security requirement (and its x-required-scope extension) names the minimum scope it needs; request the least-privileged key that covers the operations you call.

Body

application/json

Same filter shape as ListMentionsRequest plus a format selector, an optional total-row limit cap, and an optional author pivot. Exports up to 50,000 mentions per call and returns the result as a downloadable file.

view

integer

Feed/view ID to reuse as a base filter. If filters is also provided, the two are merged (view's saved filters + inline filters both apply).

Required range: x <= 9007199254740991

filters

object

Filter object. Accepts the simple flat form ({ source: ["twitter"], sentiment: ["positive"] }) or the advanced group form with AND/OR operators. Use POST /api/v2/ai/filter-wizard to generate one from natural language.

Option 1
Option 2

Show child attributes

includeAll

boolean

default:false

When true, includes low-relevance mentions (internal relevanceScore = 2). Default false returns only high and medium relevance (scores 0 and 1).

includeEngagementMetrics

boolean

When true, enriches each returned mention with the latest public engagement snapshot (engagementMetrics and engagementObservedAt). Default false omits those optional fields and avoids the additional Tinybird engagement-state join. This controls response enrichment only; engagement filters still work without it.

includeRelevantOnly

boolean

When true, forces relevant-only results (scores 0 and 1) even if includeAll is true. Convenience parity with the in-app feed toggle; omit to defer to includeAll.

cursor

string

Opaque cursor from a previous response's pagination.nextCursor.

string

Free-text search. Case-insensitive substring match across the mention's title, body, author handle, and author display name. Composes with view/filters (AND semantics). Empty or whitespace-only values are ignored.

Maximum string length: 200

format

enum<string>

default:json

Response format. json returns a downloadable JSON file ({data, total}); csv keeps the original 15-column prefix. When requested, the established engagementMetrics and engagementObservedAt columns remain immediately after that prefix. Flattened review metadata (reviewRating, reviewRatingMax, reviewVerified, reviewResponse, reviewResponseAt, reviewTargetName) follows.

Available options:

json,

csv

Example:

"csv"

limit

integer

Cap the export at the first N matching mentions (1-50,000). A TOTAL row cap, not a page size — the export paginates internally. Omit for the full 50,000-row cap.

Required range: 1 <= x <= 50000

author

string

Export one author's mentions instead of the filtered feed (the by-author lookup): the author's handle, or for source: ["linkedin"] a profile URL/slug. Requires filters to contain exactly one source platform and nothing else, and cannot be combined with view or search — the by-author lookup honors none of them.

Required string length: 1 - 500

Response

200 response

JSON shape returned when format=json. When format=csv, the response is text/csv with a matching X-Total-Count header.

data

object[]

required

Exported mentions in the same shape as the list endpoint.

Show child attributes

total

integer

required

Total matching mentions returned. Up to the 50,000 export cap.

Required range: -9007199254740991 <= x <= 9007199254740991

Export mentions

curl --request POST \
  --url https://app.octolens.com/api/v2/mentions/export \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "view": 123,
  "filters": {
    "source": [
      "reddit"
    ],
    "sentiment": [],
    "keyword": [
      0
    ],
    "language": [],
    "tag": [
      "<string>"
    ],
    "relevance": [
      "<string>"
    ],
    "reviewRating": [
      3
    ],
    "postType": [],
    "engagement": [
      {
        "source": "twitter",
        "metric": "likes",
        "value": 100,
        "operator": ">="
      }
    ],
    "!source": [
      "reddit"
    ],
    "!sentiment": [],
    "!keyword": [
      0
    ],
    "!language": [],
    "!tag": [
      "<string>"
    ],
    "!relevance": [
      "<string>"
    ],
    "!reviewRating": [
      3
    ],
    "!postType": [],
    "minXFollowers": 4503599627370495,
    "maxXFollowers": 4503599627370495,
    "startDate": "<string>",
    "endDate": "<string>"
  },
  "includeAll": false,
  "includeEngagementMetrics": true,
  "includeRelevantOnly": true,
  "cursor": "<string>",
  "search": "<string>",
  "format": "csv",
  "limit": 25000,
  "author": "<string>"
}
'

import requests

url = "https://app.octolens.com/api/v2/mentions/export"

payload = {
    "view": 123,
    "filters": {
        "source": ["reddit"],
        "sentiment": [],
        "keyword": [0],
        "language": [],
        "tag": ["<string>"],
        "relevance": ["<string>"],
        "reviewRating": [3],
        "postType": [],
        "engagement": [
            {
                "source": "twitter",
                "metric": "likes",
                "value": 100,
                "operator": ">="
            }
        ],
        "!source": ["reddit"],
        "!sentiment": [],
        "!keyword": [0],
        "!language": [],
        "!tag": ["<string>"],
        "!relevance": ["<string>"],
        "!reviewRating": [3],
        "!postType": [],
        "minXFollowers": 4503599627370495,
        "maxXFollowers": 4503599627370495,
        "startDate": "<string>",
        "endDate": "<string>"
    },
    "includeAll": False,
    "includeEngagementMetrics": True,
    "includeRelevantOnly": True,
    "cursor": "<string>",
    "search": "<string>",
    "format": "csv",
    "limit": 25000,
    "author": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    view: 123,
    filters: {
      source: ['reddit'],
      sentiment: [],
      keyword: [0],
      language: [],
      tag: ['<string>'],
      relevance: ['<string>'],
      reviewRating: [3],
      postType: [],
      engagement: [{source: 'twitter', metric: 'likes', value: 100, operator: '>='}],
      '!source': ['reddit'],
      '!sentiment': [],
      '!keyword': [0],
      '!language': [],
      '!tag': ['<string>'],
      '!relevance': ['<string>'],
      '!reviewRating': [3],
      '!postType': [],
      minXFollowers: 4503599627370495,
      maxXFollowers: 4503599627370495,
      startDate: '<string>',
      endDate: '<string>'
    },
    includeAll: false,
    includeEngagementMetrics: true,
    includeRelevantOnly: true,
    cursor: '<string>',
    search: '<string>',
    format: 'csv',
    limit: 25000,
    author: '<string>'
  })
};

fetch('https://app.octolens.com/api/v2/mentions/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.octolens.com/api/v2/mentions/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'view' => 123,
    'filters' => [
        'source' => [
                'reddit'
        ],
        'sentiment' => [
                
        ],
        'keyword' => [
                0
        ],
        'language' => [
                
        ],
        'tag' => [
                '<string>'
        ],
        'relevance' => [
                '<string>'
        ],
        'reviewRating' => [
                3
        ],
        'postType' => [
                
        ],
        'engagement' => [
                [
                                'source' => 'twitter',
                                'metric' => 'likes',
                                'value' => 100,
                                'operator' => '>='
                ]
        ],
        '!source' => [
                'reddit'
        ],
        '!sentiment' => [
                
        ],
        '!keyword' => [
                0
        ],
        '!language' => [
                
        ],
        '!tag' => [
                '<string>'
        ],
        '!relevance' => [
                '<string>'
        ],
        '!reviewRating' => [
                3
        ],
        '!postType' => [
                
        ],
        'minXFollowers' => 4503599627370495,
        'maxXFollowers' => 4503599627370495,
        'startDate' => '<string>',
        'endDate' => '<string>'
    ],
    'includeAll' => false,
    'includeEngagementMetrics' => true,
    'includeRelevantOnly' => true,
    'cursor' => '<string>',
    'search' => '<string>',
    'format' => 'csv',
    'limit' => 25000,
    'author' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://app.octolens.com/api/v2/mentions/export"

	payload := strings.NewReader("{\n  \"view\": 123,\n  \"filters\": {\n    \"source\": [\n      \"reddit\"\n    ],\n    \"sentiment\": [],\n    \"keyword\": [\n      0\n    ],\n    \"language\": [],\n    \"tag\": [\n      \"<string>\"\n    ],\n    \"relevance\": [\n      \"<string>\"\n    ],\n    \"reviewRating\": [\n      3\n    ],\n    \"postType\": [],\n    \"engagement\": [\n      {\n        \"source\": \"twitter\",\n        \"metric\": \"likes\",\n        \"value\": 100,\n        \"operator\": \">=\"\n      }\n    ],\n    \"!source\": [\n      \"reddit\"\n    ],\n    \"!sentiment\": [],\n    \"!keyword\": [\n      0\n    ],\n    \"!language\": [],\n    \"!tag\": [\n      \"<string>\"\n    ],\n    \"!relevance\": [\n      \"<string>\"\n    ],\n    \"!reviewRating\": [\n      3\n    ],\n    \"!postType\": [],\n    \"minXFollowers\": 4503599627370495,\n    \"maxXFollowers\": 4503599627370495,\n    \"startDate\": \"<string>\",\n    \"endDate\": \"<string>\"\n  },\n  \"includeAll\": false,\n  \"includeEngagementMetrics\": true,\n  \"includeRelevantOnly\": true,\n  \"cursor\": \"<string>\",\n  \"search\": \"<string>\",\n  \"format\": \"csv\",\n  \"limit\": 25000,\n  \"author\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.octolens.com/api/v2/mentions/export")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"view\": 123,\n  \"filters\": {\n    \"source\": [\n      \"reddit\"\n    ],\n    \"sentiment\": [],\n    \"keyword\": [\n      0\n    ],\n    \"language\": [],\n    \"tag\": [\n      \"<string>\"\n    ],\n    \"relevance\": [\n      \"<string>\"\n    ],\n    \"reviewRating\": [\n      3\n    ],\n    \"postType\": [],\n    \"engagement\": [\n      {\n        \"source\": \"twitter\",\n        \"metric\": \"likes\",\n        \"value\": 100,\n        \"operator\": \">=\"\n      }\n    ],\n    \"!source\": [\n      \"reddit\"\n    ],\n    \"!sentiment\": [],\n    \"!keyword\": [\n      0\n    ],\n    \"!language\": [],\n    \"!tag\": [\n      \"<string>\"\n    ],\n    \"!relevance\": [\n      \"<string>\"\n    ],\n    \"!reviewRating\": [\n      3\n    ],\n    \"!postType\": [],\n    \"minXFollowers\": 4503599627370495,\n    \"maxXFollowers\": 4503599627370495,\n    \"startDate\": \"<string>\",\n    \"endDate\": \"<string>\"\n  },\n  \"includeAll\": false,\n  \"includeEngagementMetrics\": true,\n  \"includeRelevantOnly\": true,\n  \"cursor\": \"<string>\",\n  \"search\": \"<string>\",\n  \"format\": \"csv\",\n  \"limit\": 25000,\n  \"author\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.octolens.com/api/v2/mentions/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"view\": 123,\n  \"filters\": {\n    \"source\": [\n      \"reddit\"\n    ],\n    \"sentiment\": [],\n    \"keyword\": [\n      0\n    ],\n    \"language\": [],\n    \"tag\": [\n      \"<string>\"\n    ],\n    \"relevance\": [\n      \"<string>\"\n    ],\n    \"reviewRating\": [\n      3\n    ],\n    \"postType\": [],\n    \"engagement\": [\n      {\n        \"source\": \"twitter\",\n        \"metric\": \"likes\",\n        \"value\": 100,\n        \"operator\": \">=\"\n      }\n    ],\n    \"!source\": [\n      \"reddit\"\n    ],\n    \"!sentiment\": [],\n    \"!keyword\": [\n      0\n    ],\n    \"!language\": [],\n    \"!tag\": [\n      \"<string>\"\n    ],\n    \"!relevance\": [\n      \"<string>\"\n    ],\n    \"!reviewRating\": [\n      3\n    ],\n    \"!postType\": [],\n    \"minXFollowers\": 4503599627370495,\n    \"maxXFollowers\": 4503599627370495,\n    \"startDate\": \"<string>\",\n    \"endDate\": \"<string>\"\n  },\n  \"includeAll\": false,\n  \"includeEngagementMetrics\": true,\n  \"includeRelevantOnly\": true,\n  \"cursor\": \"<string>\",\n  \"search\": \"<string>\",\n  \"format\": \"csv\",\n  \"limit\": 25000,\n  \"author\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": 0,
      "sourceId": "reddit_t3_1abc234",
      "url": "https://reddit.com/r/example/comments/abc123/...",
      "title": "<string>",
      "body": "<string>",
      "source": "reddit",
      "timestamp": "2026-05-06 13:35:37.000",
      "author": "jane.doe",
      "authorName": "<string>",
      "authorAvatar": "<string>",
      "authorUrl": "<string>",
      "authorFollowers": 0,
      "relevance": "relevant",
      "relevanceComment": "<string>",
      "sentiment": "Neutral",
      "language": "english",
      "tags": [
        "competitor_mention",
        "pricing"
      ],
      "keywords": [
        {
          "id": 42,
          "keyword": "social listening"
        }
      ],
      "engaged": true,
      "isReply": true,
      "review": {
        "rating": 1,
        "ratingMax": 123,
        "verified": true,
        "response": "<string>",
        "responseAt": "<string>",
        "targetName": "<string>"
      },
      "relevanceScore": 123,
      "feedbackRelevant": 123,
      "imageUrl": "<string>",
      "keywordId": 123,
      "engagementMetrics": {
        "likes": 120,
        "replies": 8,
        "views": 4200
      },
      "engagementObservedAt": "<string>"
    }
  ],
  "total": 0
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "status": 404,
    "details": [
      "<unknown>"
    ],
    "upgradeUrl": "https://app.octolens.com/me/upgrade?src=agents",
    "upgradeCommand": "octolens upgrade"
  }
}