Skip to main content
GET
/
export
curl "https://app.neariq.io/api/v1/export?tab=competitors&format=xlsx&fields=competitor.name,competitor.rating" \
  -H "X-NearIQ-Key: niq_your_key_here"
Export account data from stored NearIQ rows. Export reads do not trigger provider lookups or paid data refreshes. Public v1 exports return raw stored facts and reject generated scores, classifications, recommendations, valuations, projections, and other dashboard-only intelligence fields.
X-NearIQ-Key
string
required
Your API key from Settings > API Keys. Required scope: export.
tab
string
default:"overview"
One or more comma-separated tabs: competitors, reviews, ranks, alerts, content, ai-visibility, signals, gap-analysis, citations, gbp-insights, market, reports, agents, jobs, overview, or map.
format
string
default:"json"
Response format: json, csv, xlsx, or gsheets.
dateRange
string
default:"90d"
Time range: 7d, 14d, 30d, 90d, 1y, or all.
fields
string
Optional comma-separated metric registry keys such as competitor.name,competitor.rating. Redacted intelligence fields are rejected before data is loaded.
competitorId
string
Optional competitor UUID for detail exports. Detail exports include snapshots, review breakdown, products, hiring rows, ad rows, and tech stack rows for that competitor.
Exports are limited to 10 exports per hour per account. Use fields when you only need specific metric registry columns.

Single Export

curl "https://app.neariq.io/api/v1/export?tab=competitors&format=xlsx&fields=competitor.name,competitor.rating" \
  -H "X-NearIQ-Key: niq_your_key_here"

Full Account Bundle

GET /api/v1/export/all?format=zip bundles JSON, CSV, and Excel files for every export tab into one ZIP.
curl "https://app.neariq.io/api/v1/export/all?format=zip" \
  -H "X-NearIQ-Key: niq_your_key_here" \
  --output neariq-export.zip

Google Sheets

Use format=gsheets to create a spreadsheet from the export. If Google Sheets authorization is missing or the existing Google connection lacks Sheets scope, the response returns google_sheets_authorization_required with a one-time consent URL. Visit that URL while signed in, approve the added Sheets scope, then retry the export.