Export Project Data

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/export?timeframe=30d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/export",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d"},
)
export_payload = r.json()["data"]
print(export_payload["timeframeDays"], len(export_payload["prompts"]))

{
  "data": {
    "exportedAt": "2026-03-29T16:45:00.000Z",
    "timeframeDays": 30,
    "prompts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "prompt": "Best AI visibility platforms including Finseo",
        "domain": "finseo.ai",
        "brandName": "finseo",
        "language": "en",
        "tags": ["branded", "comparison"],
        "models": ["chatgpt", "claude", "perplexity"],
        "resultCount": 6,
        "results": [
          {
            "id": "r1e2s3u4-l5t6-7890-abcd-ef1234567890",
            "model": "chatgpt",
            "visible": true,
            "mentions": 3,
            "position": 2,
            "percentageRank": 18.5,
            "timestamp": "2026-03-28T14:02:11.000Z",
            "fanOutQueries": ["AI SEO tools 2026", "Finseo reviews"]
          }
        ]
      }
    ]
  }
}

GET

projects

{projectId}

export

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/export?timeframe=30d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/export",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d"},
)
export_payload = r.json()["data"]
print(export_payload["timeframeDays"], len(export_payload["prompts"]))

{
  "data": {
    "exportedAt": "2026-03-29T16:45:00.000Z",
    "timeframeDays": 30,
    "prompts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "prompt": "Best AI visibility platforms including Finseo",
        "domain": "finseo.ai",
        "brandName": "finseo",
        "language": "en",
        "tags": ["branded", "comparison"],
        "models": ["chatgpt", "claude", "perplexity"],
        "resultCount": 6,
        "results": [
          {
            "id": "r1e2s3u4-l5t6-7890-abcd-ef1234567890",
            "model": "chatgpt",
            "visible": true,
            "mentions": 3,
            "position": 2,
            "percentageRank": 18.5,
            "timestamp": "2026-03-28T14:02:11.000Z",
            "fanOutQueries": ["AI SEO tools 2026", "Finseo reviews"]
          }
        ]
      }
    ]
  }
}

Exports prompts with nested tracking results for the selected timeframe. Intended for offline analysis, BI tools, or backups of Finseo AI visibility data from ChatGPT, Claude, Perplexity, and other models.

string

required

Project identifier.

string

default:"30d"

Rolling window of results to include (max 1000 prompts; results bounded by date range). Ignored when startDate/endDate are set.

string

Custom range start (YYYY-MM-DD). Must be combined with endDate; overrides timeframe.

string

Custom range end (YYYY-MM-DD). Must be combined with startDate.

string

Parsed on shared schema; export handler may include all models in results.

string

Parsed on shared schema.

string

Parsed on shared schema.

integer

Parsed on shared schema.

integer

Parsed on shared schema.

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/export?timeframe=30d' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/export",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d"},
)
export_payload = r.json()["data"]
print(export_payload["timeframeDays"], len(export_payload["prompts"]))

{
  "data": {
    "exportedAt": "2026-03-29T16:45:00.000Z",
    "timeframeDays": 30,
    "prompts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "prompt": "Best AI visibility platforms including Finseo",
        "domain": "finseo.ai",
        "brandName": "finseo",
        "language": "en",
        "tags": ["branded", "comparison"],
        "models": ["chatgpt", "claude", "perplexity"],
        "resultCount": 6,
        "results": [
          {
            "id": "r1e2s3u4-l5t6-7890-abcd-ef1234567890",
            "model": "chatgpt",
            "visible": true,
            "mentions": 3,
            "position": 2,
            "percentageRank": 18.5,
            "timestamp": "2026-03-28T14:02:11.000Z",
            "fanOutQueries": ["AI SEO tools 2026", "Finseo reviews"]
          }
        ]
      }
    ]
  }
}

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Tasks

Export

Attribution

Export Project Data