Exports

Get an export

Poll an export. Once status is done, the whole bundle is on the response.

GEThttps://api.vidrys.com/v1/exports/{export_id}

Plan: Custom
Key: read
Rate cost: 1 unit

Poll gently — every few seconds is plenty, and each poll spends a rate-limit unit like any other call.

Get an export

curl --request GET \
  --url "https://api.vidrys.com/v1/exports/{export_id}" \
  --header "Authorization: Bearer $VIDRYS_API_KEY"

200 · success

{
  "id": "6f5e4d3c-2b1a-4098-8765-4321fedcba98",
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "done",
  "created_at": "2026-09-22T08:14:02Z",
  "completed_at": "2026-09-22T08:15:37Z",
  "error": null,
  "bundle": {
    "generated_at": "2026-09-22T08:15:37Z",
    "project": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "Acme Invoicing",
      "industry": "Accounting software"
    },
    "visibility": {
      "range": "90d",
      "metrics": [
        "…"
      ],
      "platforms": [
        "…"
      ],
      "alerts": []
    },
    "prompts": [
      "…"
    ],
    "results": [
      "…"
    ],
    "gaps": [
      "…"
    ],
    "citations": [
      "…"
    ],
    "content_assets": [
      "…"
    ],
    "queue": [
      "…"
    ]
  }
}

Authorization

Sent as a header on every request.

Authorizationstringrequired

A Vidrys API key, sent as Bearer vidrys_sk_…. A read key is enough. See Authentication.

Path parameters

export_idstringrequired

The id returned when the export was requested.

Response · 200

application/json

idstring

Export id.

project_idstring

The project exported.

statusstring

Where the job is.

Values:pendingrunningdonefailed

created_atstring

When it was requested (ISO 8601).

completed_atstringnullable

When it finished.

errorstringnullable

Why it failed.

bundleobjectnullable

The data, once status is done — only on Get an export. Each section is what the matching endpoint returns, every page included; a section the plan or project can't read is null.

+Show child attributes

generated_atstring

When the bundle was built (ISO 8601).

projectobject

The project.

+Show child attributes

idstring

Project id (a UUID). Every project-scoped call takes it.

namestring

The brand the project tracks.

industrystringnullable

The industry set on the project.

visibilityobjectnullable

Visibility overview over 90d.

visibility_trendobjectnullable

Visibility trend over 90d.

promptsobject[]

Every prompt.

resultsobject[]

Every latest-run result.

gapsobject[]

Every gap.

citationsobject[]

Every cited domain.

sentimentobjectnullable

Sentiment over 90d.

competitorsobjectnullable

Competitor standings.

competitor_analysisobjectnullable

Competitor analysis.

content_assetsobject[]

Every content opportunity.

queueobject[]

Every content-queue task.

impactobjectnullable

Impact.

topic_coverageobjectnullable

Topic coverage.

site_auditobjectnullable

Site audit.

ai_referralsobjectnullable

AI referral traffic.

Errors

403 plan_feature_unavailable	The feature is on a higher plan. Bulk exports and webhooks are Custom-only.
404 not_found	The project or item doesn't exist in this workspace. A project from another workspace also returns 404, never 403.
401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.