Ownership Data API

Build on top of structured ownership intelligence.

Switch To India API is designed for enterprise dashboards, analyst workflows, and policy-monitoring systems that need structured ownership and control signals.

Request API Access Open Enterprise Workspace

Authentication

API key via header

Use either x-api-key or Authorization: Bearer <key>. Each key is scoped and rate-limited per minute.

curl -X GET \
  "https://switchtoindia.in/api/v1/ownership/brands/amul" \
  -H "x-api-key: <YOUR_API_KEY>"

Endpoints

Current v1 surface

GET/api/v1/ownership/brands/[slug]

Returns brand ownership profile, latest ownership score, and controlling group links.

Scope: ownership.read

GET/api/v1/ownership/segments/[slug]

Returns segment-level ownership split and latest score snapshot.

Scope: ownership.read

GET/api/v1/comparisons/segment-options?segment=<slug>

Returns normalized brand and product options for segment-based comparisons.

Scope: ownership.read

GET/api/v1/workspaces

Lists enterprise workspaces attached to the API key organization.

Scope: workspace.read

POST/api/v1/workspaces

Creates a new enterprise workspace under the API key organization.

Scope: workspace.write

GET/api/v1/workspaces/[workspaceId]/watchlists

Lists watchlist entities tracked in a workspace.

Scope: workspace.read

POST/api/v1/workspaces/[workspaceId]/watchlists

Adds watchlist entities for monitoring.

Scope: workspace.write

GET/api/v1/ads/samples

Returns sample formats for featured alternative, analyzer visibility, enhanced profile, and category spotlight placements.

Scope: ads.read

Scopes

Recommended scope model

ownership.read

Brand and segment ownership intelligence plus comparison options.

workspace.read / workspace.write

Enterprise workspace and watchlist lifecycle operations.

ads.read

Placement and sample inventory for media planning teams.

Wildcard support

Prefix wildcards are supported, for example ownership.* and workspace.*.