Advanced API Usage

Authorization: Bearer sea_your_key_here

GET /api/v1/projects/{projectId}/audits?includeIssues=true

const res = await fetch(
  'https://app.searchable.com/api/v1/projects/PROJECT_ID/audits?includeIssues=true',
  { headers: { Authorization: 'Bearer sea_YOUR_KEY' } }, // requires the `read` scope
);
const { summary, audits } = await res.json();
// summary.totalPages     — pages with at least one completed audit (not all tracked pages)
// summary.lastCompletedAt — newest completed audit across all pages
// audits[].openIssues     — present only when includeIssues=true

POST /api/mcp/projects/{projectId}/reports

const res = await fetch(
  'https://app.searchable.com/api/mcp/projects/PROJECT_ID/reports',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer sea_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      reportType: 'combined',   // "sentiment" | "visibility" | "combined" (default "sentiment")
      timeRange: '30d',         // "7d" | "30d" | "90d" | "365d" (default "30d")
      status: 'published',      // "published" | "draft" (default "published")
      // optional filters: platforms, topicIds, locationIds (string arrays)
      // optional: title, unbrandedOnly, brandedOnly
    }),
  },
);
const { shareUrl, shareToken, reportType, success } = await res.json();