1from apify_client import ApifyClient
2
3
4
5client = ApifyClient("<YOUR_API_TOKEN>")
6
7
8run_input = {
9 "schemaVersion": "1.0",
10 "analysisId": "acme-ai-sov-2026-q4",
11 "targetBrand": "Acme",
12 "competitors": [
13 "Beta",
14 "Gamma",
15 ],
16 "observations": [
17 {
18 "schemaVersion": "1.0",
19 "observationId": "1dd0242ec51569d105f1d541f97fec03202ff2632f507b5b03f45393a0985793",
20 "brand": "Acme",
21 "competitors": ["Beta"],
22 "modelFamily": "ChatGPT",
23 "market": "US",
24 "language": "en",
25 "mentioned": True,
26 "position": 1,
27 },
28 {
29 "schemaVersion": "1.0",
30 "observationId": "6d5d40cc4239b90a29a6b01f05afc95f6014e147653733a88c0b8b0cc2f9608b",
31 "brand": "Acme",
32 "competitors": [
33 "Beta",
34 "Gamma",
35 ],
36 "modelFamily": "ChatGPT",
37 "market": "US",
38 "language": "en",
39 "mentioned": False,
40 "position": None,
41 },
42 {
43 "schemaVersion": "1.0",
44 "observationId": "02bb02668bb610c21e80f39887124fcbe21ba70cce9ea951f5545cfee30a11dd",
45 "brand": "Acme",
46 "competitors": ["Gamma"],
47 "modelFamily": "Gemini",
48 "market": "US",
49 "language": "en",
50 "mentioned": True,
51 "position": 2,
52 },
53 {
54 "schemaVersion": "1.0",
55 "observationId": "6d2f681dd1da0ee26756b2b6d918f20534226762040feaf0ef200c419008c7d7",
56 "brand": "Acme",
57 "competitors": [],
58 "modelFamily": "Gemini",
59 "market": "UK",
60 "language": "en",
61 "mentioned": True,
62 "position": 1,
63 },
64 {
65 "schemaVersion": "1.0",
66 "observationId": "4ca3603e3fc5118141211654becfa32d6a52b8d9c175e750205f249ffadced9c",
67 "brand": "Acme",
68 "competitors": ["Beta"],
69 "modelFamily": "Perplexity",
70 "market": "UK",
71 "language": "en",
72 "mentioned": False,
73 "position": None,
74 },
75 {
76 "schemaVersion": "1.0",
77 "observationId": "75156e90a81c700b669dec421a50880014a91bc7a42a7a337d1f7655a3cb7cba",
78 "brand": "Acme",
79 "competitors": [
80 "Beta",
81 "Gamma",
82 ],
83 "modelFamily": "Perplexity",
84 "market": "US",
85 "language": "en",
86 "mentioned": True,
87 "position": 1,
88 },
89 ],
90 "maximumSegmentsPerDimension": 10,
91}
92
93
94run = client.actor("zinin/ai-visibility-competitor-share-of-voice").call(run_input=run_input)
95
96
97print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
98for item in client.dataset(run.default_dataset_id).iterate_items():
99 print(item)
100
101