# Arcmira API > Arcmira's media intelligence API: search entities, resolve stable IDs, pull mentions and appearances, manage monitors and trackers, and query commercial intelligence on ad reads and channel sponsors. > ## Agent Instructions > Arcmira has three API capabilities: Search (entities, mentions, appearances, commercial intelligence), Monitors (trackers plus alert delivery), and Transcripts (read, generate, correct). Community Review is the cross-surface correction layer. > Discover pages at https://arcmira.com/docs/llms.txt, then fetch the matching page's .md export. Each capability has a self-contained ' for coding agents' page; prefer it. > Auth: Authorization: Bearer arc_sk_... or x-api-key: arc_sk_... (x-api-key wins if both are sent). Never put keys in browser code. Check GET /v1/me for tier, scopes, and remaining rows before metered pulls. > Search: resolve names with GET /v1/entities/lookup and pin ent_* IDs before pulling metered rows. Only person entities have appearances. Mention and recommendation rows carry canonical numeric timestamps in start_seconds/end_seconds (integer seconds; 0 means full episode); the MM:SS string fields are deprecated. Commercial routes need Pro+ tier AND the recommendations:read scope and bill 10 rows per row. > Monitors: a tracker watches one entity; a monitor groups trackers with shared delivery (email, Slack, HMAC-signed webhooks). Create trackers with POST /v1/trackers, then attach by id: POST /v1/monitors/{id}/trackers { trackerIds: [...] }. Each fired alert occurrence debits 100 rows. Poll GET /v1/monitors/{id}/alerts?n= for recent deliveries. Send Idempotency-Key on every POST/PATCH. > Transcripts: switch on the access field (unlocked, locked, premium_pending, not_transcribed, unauthenticated). Honor Retry-After when polling POST /v1/transcriptions jobs. Corrections (POST /v1/videos/{video_id}/corrections; kinds line_edit, speaker_reassign, speaker_identify, add_person, entity_tag, segment_rewrite) cost 0 rows; anchored kinds need revision + anchor.contentHash (djb2 base-36); handle 409 (re-anchor) and 412 (expectedSeq). segment_rewrite replaces an inclusive segment range with new segments (empty replacements array deletes; timestamps repaired server-side). > Community Review is free (0 rows) and surface-typed: POST /v1/feedback with a type matching the surface you called, the reproducing query, and corrections targeting public IDs (ent_*, men_*, com_*). Nothing auto-applies. Do not send untyped notes. > Errors: switch on error.code, follow doc_url, quote X-Request-Id to support. Honor Retry-After on 429. Retries of POST/PATCH must reuse the same Idempotency-Key; replays return Idempotency-Replayed: true. > Teams Admin API: GET /v1/team/members, /v1/team/spend, /v1/team/usage-events (cursor-paginated, 90-day bound) are read-only and require a team-scoped API key created by a team admin; personal keys get 403 team_key_required. ## Docs - [AGENTS](https://arcmira.com/docs/AGENTS.md) - [List person appearances](https://arcmira.com/docs/api-reference/appearances/list-person-appearances.md): Appearances (the person was actually present in the media) for one person, newest first. Person-only: the equivalent route for any other entity type returns a 400 (appearances_person_only). DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } w… - [Get a channel entity page](https://arcmira.com/docs/api-reference/channels/get-a-channel-entity-page.md): Channel pages include a recommendations_summary teaser: sponsor_count for all callers; top_sponsors additionally requires a Pro+ plan with the recommendations:read scope. - [List channel guests](https://arcmira.com/docs/api-reference/channels/list-channel-guests.md): People who appeared as guests on the channel, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route today. - [List channels related to a channel](https://arcmira.com/docs/api-reference/channels/list-channels-related-to-a-channel.md): The channels that co-occur with this channel in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route… - [List organizations related to a channel](https://arcmira.com/docs/api-reference/channels/list-organizations-related-to-a-channel.md): The organizations that co-occur with this channel in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this r… - [List people related to a channel](https://arcmira.com/docs/api-reference/channels/list-people-related-to-a-channel.md): The people that co-occur with this channel in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route to… - [List products related to a channel](https://arcmira.com/docs/api-reference/channels/list-products-related-to-a-channel.md): The products that co-occur with this channel in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route… - [List topics related to a channel](https://arcmira.com/docs/api-reference/channels/list-topics-related-to-a-channel.md): The topics that co-occur with this channel in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route to… - [Identify a diarized speaker as a person](https://arcmira.com/docs/api-reference/corrections/identify-a-diarized-speaker-as-a-person.md): Links a diarization speaker id to a person entity (or proposes a new person via `name`). Creates a community-attributed appearance immediately — it shows on the person page right away, flagged pending review; reviewers can revert it. Free (0 rows). Supports Idempotency-Key. - [List your pending video merges](https://arcmira.com/docs/api-reference/corrections/list-your-pending-video-merges.md) - [Submit a transcript correction](https://arcmira.com/docs/api-reference/corrections/submit-a-transcript-correction.md): Unified corrections ingestion for all kinds: line_edit, speaker_reassign, speaker_identify, add_person, entity_tag, segment_rewrite. Corrections are free (0 rows) and land as pending-review rows attributed to your API key; speaker_identify/add_person also create a community-flagged appearance immedi… - [Submit a transcript line-text correction](https://arcmira.com/docs/api-reference/corrections/submit-a-transcript-line-text-correction.md): Purpose-built wrapper for the line_edit kind. The edit is pending review: visible to you immediately (returned in the transcript GET `edits[]`), applied for everyone once approved. Free (0 rows), attributed to your API key. Supports Idempotency-Key. - [Submit a video-level entity merge](https://arcmira.com/docs/api-reference/corrections/submit-a-video-level-entity-merge.md): Asserts that a name in this video refers to a specific entity — for misattributed name mentions in one video (e.g. a first-name-only mention resolved to the wrong entity). Optionally respells the transcript text via `replaceWith`. Pending review; applied optimistically for you. Mentions of the same… - [Withdraw your pending entity tag](https://arcmira.com/docs/api-reference/corrections/withdraw-your-pending-entity-tag.md) - [Withdraw your pending line edit](https://arcmira.com/docs/api-reference/corrections/withdraw-your-pending-line-edit.md) - [Withdraw your pending segment rewrite](https://arcmira.com/docs/api-reference/corrections/withdraw-your-pending-segment-rewrite.md) - [Withdraw your pending speaker identification](https://arcmira.com/docs/api-reference/corrections/withdraw-your-pending-speaker-identification.md): Withdrawing also removes the community-attributed appearance the identification created. - [Withdraw your pending speaker reassign or split](https://arcmira.com/docs/api-reference/corrections/withdraw-your-pending-speaker-reassign-or-split.md) - [Withdraw your pending video merge](https://arcmira.com/docs/api-reference/corrections/withdraw-your-pending-video-merge.md) - [Batch compact entity cards by id](https://arcmira.com/docs/api-reference/entities/batch-compact-entity-cards-by-id.md): Free endpoint (0 rows). Batched compact lookups for UI hover cards: name, slug, type, image, and index counts for up to 50 raw integer entity ids per request. Merged ids resolve to their canonical entity but are returned under the requested id; unknown ids are silently dropped. The response is ident… - [Fuzzy entity discovery](https://arcmira.com/docs/api-reference/entities/fuzzy-entity-discovery.md): Substring name search returning up to 25 entities ordered by appearance count. Callers with Recommendations API access (Pro+ plan with the recommendations:read scope) also receive a recommendations_summary per result when a brand profile exists. - [Get canonical entity metadata](https://arcmira.com/docs/api-reference/entities/get-canonical-entity-metadata.md): Returns the canonical entity envelope for an ent_{n} or numeric id, following merge redirects. For organization and product entities, callers with Recommendations API access (Pro+ plan with the recommendations:read scope) also receive a recommendations_summary commercial-intelligence rollup when a b… - [Resolve an entity to its canonical stable ID](https://arcmira.com/docs/api-reference/entities/resolve-an-entity-to-its-canonical-stable-id.md): Resolves an id or name to the canonical entity record, following merge redirects. Pass either id (ent_{n} or numeric) or name, optionally constrained by type. - [Read back a feedback submission and its review status](https://arcmira.com/docs/api-reference/feedback/read-back-a-feedback-submission-and-its-review-status.md): Returns the submission (id, type, query, notes, created_at) plus its per-correction rows, each with a review status in the public vocabulary: pending_review, needs_information, accepted, accepted_with_changes, rejected, withdrawn, applied, reverted (accepted means a reviewer agreed; applied means th… - [Submit feedback and corrections for a prior API query](https://arcmira.com/docs/api-reference/feedback/submit-feedback-and-corrections-for-a-prior-api-query.md): Attach corrections to the exact query you ran: pass the feedback type, the query object you sent, and optional per-item corrections. Public submissions are recorded for human review (status "logged"); nothing is auto-applied. Read the review status back later via GET /v1/feedback/{feedback_id}. reco… - [List mentions for an entity](https://arcmira.com/docs/api-reference/mentions/list-mentions-for-an-entity.md): Cursor-paginated mentions for one entity, newest media first. Read timestamps from start_seconds / end_seconds (integer seconds; 0 means full episode); the MM:SS (or HH:MM:SS) string fields are deprecated. is_appearance filtering applies to person entities only; passing is_appearance=true for any ot… - [Search mentions across media](https://arcmira.com/docs/api-reference/mentions/search-mentions-across-media.md): Cursor-paginated mentions filtered by entity (entity_id or entity_name is required), channel, text query, sentiment, appearance flag, and date range. Read timestamps from start_seconds / end_seconds (integer seconds; 0 means full episode); the MM:SS (or HH:MM:SS) string fields are deprecated. is_app… - [Current API key context](https://arcmira.com/docs/api-reference/meta/current-api-key-context.md): Returns the tier, scopes, rate limit, and row usage for the API key making the request. - [Health check](https://arcmira.com/docs/api-reference/meta/health-check.md) - [OpenAPI document](https://arcmira.com/docs/api-reference/meta/openapi-document.md) - [Add trackers to monitor](https://arcmira.com/docs/api-reference/monitors/add-trackers-to-monitor.md): Attaches EXISTING trackers to the monitor by id ({ trackerIds: ["trk_..."] }). It does not create trackers: create them first via POST /v1/trackers, then attach. Attached trackers use the monitor's delivery settings. Supports the Idempotency-Key header. - [Create monitor](https://arcmira.com/docs/api-reference/monitors/create-monitor.md): Creating with notifyWebhook: true and a webhookUrl enables HMAC-signed webhook delivery and returns the signing secret (monitor.webhookSecret) in this response. Returned only once. Store it securely; it cannot be retrieved later. To recover from a lost secret, rotate. All subsequent reads expose onl… - [Delete monitor](https://arcmira.com/docs/api-reference/monitors/delete-monitor.md): Deletes the monitor AND every tracker inside it (trackersDeleted reports how many). Cannot be undone. - [List monitor trackers](https://arcmira.com/docs/api-reference/monitors/list-monitor-trackers.md) - [List monitors](https://arcmira.com/docs/api-reference/monitors/list-monitors.md): All monitors for the account with tracker counts, alert counts for the current calendar month, and Slack display metadata. Single page, no pagination. - [List recent monitor alerts](https://arcmira.com/docs/api-reference/monitors/list-recent-monitor-alerts.md): The newest n alert deliveries for the monitor, as a single page. This endpoint does not paginate: has_more is always false and next_cursor is always null. entity_id ("ent_{n}") and mention_id ("men_{n}") are public-ID forms that join directly against entity and mention rows; media_id and appearance_… - [Rotate the monitor webhook signing secret](https://arcmira.com/docs/api-reference/monitors/rotate-the-monitor-webhook-signing-secret.md): Generates a new signing secret and returns it in this response. Returned only once. Store it securely; it cannot be retrieved later. To recover from a lost secret, rotate. Zero-downtime overlap: the previous secret remains valid until previousSecretExpiresAt (24 hours); during the window every deliv… - [Update monitor](https://arcmira.com/docs/api-reference/monitors/update-monitor.md): A PATCH that newly enables webhook signing (turns notifyWebhook on, or sets a webhookUrl where no secret existed before) returns the signing secret (monitor.webhookSecret) in this response. Returned only once. Store it securely; it cannot be retrieved later. To recover from a lost secret, rotate. Un… - [Get a organization entity page](https://arcmira.com/docs/api-reference/organizations/get-a-organization-entity-page.md) - [List channels related to a organization](https://arcmira.com/docs/api-reference/organizations/list-channels-related-to-a-organization.md): The channels that co-occur with this organization in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this r… - [List organizations related to a organization](https://arcmira.com/docs/api-reference/organizations/list-organizations-related-to-a-organization.md): The organizations that co-occur with this organization in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through t… - [List people related to a organization](https://arcmira.com/docs/api-reference/organizations/list-people-related-to-a-organization.md): The people that co-occur with this organization in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this rou… - [List products related to a organization](https://arcmira.com/docs/api-reference/organizations/list-products-related-to-a-organization.md): The products that co-occur with this organization in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this r… - [List topics related to a organization](https://arcmira.com/docs/api-reference/organizations/list-topics-related-to-a-organization.md): The topics that co-occur with this organization in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this rou… - [Get a person entity page](https://arcmira.com/docs/api-reference/people/get-a-person-entity-page.md) - [List channels related to a person](https://arcmira.com/docs/api-reference/people/list-channels-related-to-a-person.md): The channels that co-occur with this person in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route t… - [List organizations related to a person](https://arcmira.com/docs/api-reference/people/list-organizations-related-to-a-person.md): The organizations that co-occur with this person in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this ro… - [List people related to a person](https://arcmira.com/docs/api-reference/people/list-people-related-to-a-person.md): The people that co-occur with this person in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route tod… - [List products related to a person](https://arcmira.com/docs/api-reference/people/list-products-related-to-a-person.md): The products that co-occur with this person in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route t… - [List topics related to a person](https://arcmira.com/docs/api-reference/people/list-topics-related-to-a-person.md): The topics that co-occur with this person in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route tod… - [Get a product entity page](https://arcmira.com/docs/api-reference/products/get-a-product-entity-page.md) - [List channels related to a product](https://arcmira.com/docs/api-reference/products/list-channels-related-to-a-product.md): The channels that co-occur with this product in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route… - [List organizations related to a product](https://arcmira.com/docs/api-reference/products/list-organizations-related-to-a-product.md): The organizations that co-occur with this product in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this r… - [List people related to a product](https://arcmira.com/docs/api-reference/products/list-people-related-to-a-product.md): The people that co-occur with this product in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route to… - [List products related to a product](https://arcmira.com/docs/api-reference/products/list-products-related-to-a-product.md): The products that co-occur with this product in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route… - [List topics related to a product](https://arcmira.com/docs/api-reference/products/list-topics-related-to-a-product.md): The topics that co-occur with this product in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route to… - [List recommendations for an entity](https://arcmira.com/docs/api-reference/recommendations/list-recommendations-for-an-entity.md): Cursor-paginated commercial mentions (ad reads, endorsements, neutral mentions) for one entity, newest media first. Requires the recommendations:read scope on a plan with Recommendations API access. Read timestamps from start_seconds / end_seconds (integer seconds); the MM:SS string fields are depre… - [List recurring channel sponsors](https://arcmira.com/docs/api-reference/recommendations/list-recurring-channel-sponsors.md): Rollup of recurring sponsors for a YouTube channel, ordered by ad read count. Requires the recommendations:read scope on a plan with Recommendations API access. Sponsors with fewer than min_ad_reads ad reads (default 3) are excluded; status filters against the curated known-advertisers dataset. - [Search recommendations across media](https://arcmira.com/docs/api-reference/recommendations/search-recommendations-across-media.md): Cursor-paginated commercial mentions (ad reads, endorsements, neutral mentions) filtered by entity (entity_id or entity_name is required), channel, mention_class, confidence, and date range. Requires the recommendations:read scope on a plan with Recommendations API access. Read timestamps from start… - [Resolve a name to a single entity](https://arcmira.com/docs/api-reference/search/resolve-a-name-to-a-single-entity.md): Single-result name resolver: exact, case-insensitive match with curated alias support. Returns at most one entity and does not paginate (single page; there is no cursor). When `type` is passed and the name resolves to an entity of a different type, the response is `{ found: false }`. For fuzzy multi… - [List team members](https://arcmira.com/docs/api-reference/team/list-team-members.md): Active members of the team the key is scoped to, with role and seat type, earliest join first. Single page, no pagination. Requires a team-scoped API key (created by a team admin from the dashboard API Keys tab). Personal keys receive 403 (team_key_required). - [List team usage events](https://arcmira.com/docs/api-reference/team/list-team-usage-events.md): Cursor-paginated usage log across all team members, newest first, bounded to a 90-day look-back. The aggregated analytics chart data is not exposed on this API (Enterprise). Requires a team-scoped API key (created by a team admin from the dashboard API Keys tab). Personal keys receive 403 (team_key_… - [Per-member spend and rows used this period](https://arcmira.com/docs/api-reference/team/per-member-spend-and-rows-used-this-period.md): Rows consumed and on-demand overage spend for every active member in the current period. Single page, no pagination. Requires a team-scoped API key (created by a team admin from the dashboard API Keys tab). Personal keys receive 403 (team_key_required). - [Get a topic entity page](https://arcmira.com/docs/api-reference/topics/get-a-topic-entity-page.md) - [List channels related to a topic](https://arcmira.com/docs/api-reference/topics/list-channels-related-to-a-topic.md): The channels that co-occur with this topic in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route to… - [List organizations related to a topic](https://arcmira.com/docs/api-reference/topics/list-organizations-related-to-a-topic.md): The organizations that co-occur with this topic in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this rou… - [List people related to a topic](https://arcmira.com/docs/api-reference/topics/list-people-related-to-a-topic.md): The people that co-occur with this topic in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route toda… - [List products related to a topic](https://arcmira.com/docs/api-reference/topics/list-products-related-to-a-topic.md): The products that co-occur with this topic in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route to… - [List topics related to a topic](https://arcmira.com/docs/api-reference/topics/list-topics-related-to-a-topic.md): The topics that co-occur with this topic in indexed media, with q/field/sort/order filtering. DOCUMENTED EXCEPTION to the standard list contract: the response is { items, total, offset, limit, hasMore } and no next_cursor is returned, so pages past the first are not reachable through this route toda… - [Create tracker](https://arcmira.com/docs/api-reference/trackers/create-tracker.md): Creates a standalone tracker watching one entity (name + type, resolved with the same entity resolution Search uses). Attach it to a monitor afterwards via POST /v1/monitors/{id}/trackers. Creating a duplicate (same entity name + type) returns 409 with the existingId. Supports the Idempotency-Key he… - [Delete tracker](https://arcmira.com/docs/api-reference/trackers/delete-tracker.md): Deletes the tracker. Cannot be undone. - [List recent tracker alerts](https://arcmira.com/docs/api-reference/trackers/list-recent-tracker-alerts.md): The newest n alert deliveries for the tracker, as a single page. This endpoint does not paginate: has_more is always false and next_cursor is always null. entity_id ("ent_{n}") and mention_id ("men_{n}") are public-ID forms that join directly against entity and mention rows; media_id and appearance_… - [List trackers](https://arcmira.com/docs/api-reference/trackers/list-trackers.md): All trackers for the account, newest first, with per-channel delivery counts for the current billing period. Single page, no pagination. - [Update tracker](https://arcmira.com/docs/api-reference/trackers/update-tracker.md): Partial update: send only the fields to change. The tracked entity itself (entityName/entityType) is immutable; delete and recreate to watch a different entity. Supports the Idempotency-Key header. - [List your transcription requests](https://arcmira.com/docs/api-reference/transcriptions/list-your-transcription-requests.md): Your most recent transcription requests (newest first; 20 without a filter, 5 when filtered to one video). Each entry has the same shape as the status poll plus a `title` field (the video title, null when unknown). Up to 5 in-flight rows are reconciled against live pipeline state per list call, and… - [Poll transcription status](https://arcmira.com/docs/api-reference/transcriptions/poll-transcription-status.md): Agent-friendly polling contract: while the request is in flight the response carries a Retry-After header (seconds) and body fields `etaSeconds` + `nextPollSeconds` — sleep on Retry-After and re-poll. `status` walks queued → downloading → transcribing → analyzing → complete (user-facing `stage` fold… - [Submit a YouTube video for transcription](https://arcmira.com/docs/api-reference/transcriptions/submit-a-youtube-video-for-transcription.md): Paid tiers only. Rows are debited up front (75 rows per 15-minute block, minimum one) and the permanent per-video unlock is granted at submit time, so the transcript GET auto-unlocks when the pipeline finishes. If a PREMIUM transcript already exists the request short-circuits to `complete`; a video… - [Get a video transcript](https://arcmira.com/docs/api-reference/transcripts/get-a-video-transcript.md): Returns segments, speakers, and entity annotations for a video. Transcript surfaces are premium-only. Access requires a permanent per-video unlock (paid tiers). Cost is always quoted in rows and 15-minute blocks: 75 rows per 15-minute block of video, minimum one block. `access` states: `unlocked` (f… - [Authentication & scopes](https://arcmira.com/docs/authentication.md): API key headers, key hygiene, and the scope matrix that gates read and write access. - [Changelog](https://arcmira.com/docs/changelog.md): Product updates and release notes for the Arcmira API. - [Commercial intelligence](https://arcmira.com/docs/commercial-intelligence.md): Ad reads, endorsements, and channel sponsors. The commercial evidence layer behind /v1/recommendations and /v1/channels/{id}/sponsors (Pro+). - [Errors](https://arcmira.com/docs/errors.md): The error envelope, status codes, machine-stable error codes with causes and fixes, and request IDs. - [Community Review](https://arcmira.com/docs/feedback.md): The cross-surface correction layer. Typed feedback for every Search result, monitor alert, and transcript, free, against the exact query you ran. - [Quickstart](https://arcmira.com/docs/index.md) - [Monitors](https://arcmira.com/docs/monitors.md): Standing entity tracking with alert delivery to email, Slack, and HMAC-signed webhooks. Trackers, monitors, and alert history. - [Monitors for coding agents](https://arcmira.com/docs/monitors-for-coding-agents.md): Self-contained reference for Monitors and Trackers: endpoints, request bodies, alert history schema, webhook payloads, and signature verification. - [Requests & conventions](https://arcmira.com/docs/requests.md): The contracts shared by every endpoint: cursor pagination, idempotent writes, public ID schemes, headers, and versioning. - [Search](https://arcmira.com/docs/search.md): Resolve entities and pull evidence from the index: mentions, appearances, related entities, and commercial signals. - [Search for coding agents](https://arcmira.com/docs/search-for-coding-agents.md): Self-contained reference for the Search surface: every endpoint, parameter table, response schema, error, and known mistake on one page. - [Teams docs spec (for the docs-writing agent)](https://arcmira.com/docs/specs/teams-docs-spec.md): Specification for the six public Teams documentation pages, mirroring Cursor's teams docs structure with explicit Arcmira deltas. Not user-facing. - [Support & roadmap](https://arcmira.com/docs/support.md): How to get help fast, and what is intentionally not shipped yet. - [Team analytics](https://arcmira.com/docs/teams/analytics.md): Team usage analytics on the dashboard Overview tab, CSV export, and the read-only Teams Admin API. - [Team dashboard](https://arcmira.com/docs/teams/dashboard.md): Where team management lives in the Arcmira dashboard: Members, Settings, Spending, Billing, and team API keys. - [Enterprise](https://arcmira.com/docs/teams/enterprise.md): The Enterprise plan: everything in Teams plus SCIM, pooled usage, audit log access, the analytics API, and invoice billing. - [Members, roles, and seat types](https://arcmira.com/docs/teams/members.md): Team roles and permissions, seat types, the four ways members join, domain controls, and removal semantics. - [Teams pricing](https://arcmira.com/docs/teams/pricing.md): Seat types and prices, yearly billing, proration rules, and team on-demand usage. - [Get started with Teams](https://arcmira.com/docs/teams/setup.md): Create an Arcmira team, upgrade from an individual plan, invite members, and set up domain-based joining. - [SSO](https://arcmira.com/docs/teams/sso.md): Configure SAML 2.0 or OIDC single sign-on: domain verification, provider setup, JIT provisioning, and enforcement. - [Transcripts](https://arcmira.com/docs/transcripts.md): Read full annotated video transcripts, generate them on demand, and correct them through community review. - [Transcripts for coding agents](https://arcmira.com/docs/transcripts-for-coding-agents.md): Self-contained reference for transcripts: read/unlock, transcription submission and polling, and all six correction kinds with full payloads and the queue-client error contract. - [Usage, limits & billing](https://arcmira.com/docs/usage-and-billing.md): How rows, monthly quotas, on-demand spend, and per-minute rate limits work across the API. ## OpenAPI Specs - [arcmira-v1](https://arcmira.com/docs/openapi/arcmira-v1.json)