വെബ്സൈറ്റ് പ്രസാധകന്റെ വരുമാന ഓഡിറ്റ് API

വെബ്സൈറ്റ് പ്രസാധകരുടെ വരുമാന പരിശോധനകൾ നടത്തുക, Sulvo റിപ്പോർട്ടുകൾ നേടുക, അംഗീകൃത വെബ്സൈറ്റ് പ്രസാധക ഇൻവെന്ററി കൈകാര്യം ചെയ്യുക; ഇതെല്ലാം CLI-യും MCP സെർവറും ഉപയോഗിക്കുന്ന അതേ API വഴിയാണ്.

ഹോസ്റ്റ് ചെയ്ത അടിസ്ഥാന URL

https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-auditsCLI, MCP സജ്ജീകരണം

അടിസ്ഥാനങ്ങൾ

അടിസ്ഥാന URL-കൾ

പൊതു ഓഡിറ്റ് എൻഡ്‌പോയിന്റിന് ഉദ്ദേശപൂർവം പ്രാമാണീകരണം ആവശ്യമില്ല. Sulvo അക്കൗണ്ട് റിപ്പോർട്ടുകൾക്കും ഇൻവെന്ററി അഭ്യർത്ഥനകൾക്കും ഡാഷ്ബോർഡിൽ സൃഷ്ടിച്ച API കീ ഉപയോഗിക്കുന്നു.

പൊതു ഓഡിറ്റ് API

POST

https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-audits

Sulvo അക്കൗണ്ട് API

Bearer API കീ

https://surge.sulvo.com/api

ഹോസ്റ്റുചെയ്ത MCP എൻഡ്‌പോയിന്റ്

MCP

https://publisher-revenue-audit.sulvo.com/mcp

പൊതു എൻഡ്‌പോയിന്റ്

വരുമാന ഓഡിറ്റ് നടത്തുക

വെബ്സൈറ്റ് പ്രസാധകന്റെ ഡൊമെയ്‌നിലെ പൊതുവായി ലഭ്യമായ തെളിവുകൾ അടിസ്ഥാനമാക്കിയുള്ള ഏകദേശ പരിശോധനയ്ക്ക് ഈ എൻഡ്‌പോയിന്റ് ഉപയോഗിക്കുക. പ്രതികരണം വരുമാന നഷ്ടത്തിന്റെ തെളിവോ ഉറപ്പായ വർധനയോ അല്ല. കണ്ടെത്തലുകൾ പ്രസാധകന്റെ സ്വന്തം റിപ്പോർട്ടുകളുമായി പരിശോധിക്കുക.

cURL

curl -X POST https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-audits \
  -H "content-type: application/json" \
  -d '{
    "tool": "run_publisher_revenue_audit",
    "input": {
      "domain": "example.com",
      "vertical": "news",
      "options": {
        "format": "json",
        "compact": true,
        "maxPages": 2,
        "enablePageSpeed": true
      }
    }
  }'

ഫീൽഡ്	കുറിപ്പുകൾ
input.domain	ആവശ്യമായ വെബ്സൈറ്റ് പ്രസാധകന്റെ ഡൊമെയ്ൻ അല്ലെങ്കിൽ പൊതു ഹോസ്റ്റ്. പ്രോട്ടോക്കോൾ ഇല്ലാത്ത ഡൊമെയ്‌നുകൾ HTTPS ആയി ക്രമീകരിക്കും. സ്വകാര്യ ലക്ഷ്യങ്ങൾ, അസംസ്കൃത IP-കൾ, ആഭ്യന്തര ഹോസ്റ്റുകൾ, സ്റ്റാൻഡേർഡ് അല്ലാത്ത പോർട്ടുകൾ എന്നിവ നിരസിക്കും.
input.vertical	ഓപ്ഷണൽ. news, sports, entertainment, technology, education, gaming, അല്ലെങ്കിൽ other എന്നിവ സ്വീകരിക്കുന്നു.
input.metrics	വെബ്സൈറ്റ് പ്രസാധകൻ നൽകുന്ന ഐച്ഛിക ഡാഷ്ബോർഡ് വിവരങ്ങൾ, ഉദാഹരണത്തിന് ഫിൽ റേറ്റ്, വ്യൂവബിലിറ്റി, ശരാശരി CPM, ഓരോ സെഷനിലെയും വരുമാനം, പ്രതിമാസ പേജ് കാഴ്ചകൾ, അല്ലെങ്കിൽ പ്രതിമാസ സെഷനുകൾ.
input.options	format, compact, maxPages, includeEvidence, enableBrowser, includeScreenshots, enablePageSpeed, pageSpeedStrategy, concurrency, whiteLabel, partnerId എന്നിവ ഉൾപ്പെടുന്ന ഔട്ട്‌പുട്ട്, ശേഖരണ നിയന്ത്രണങ്ങൾക്കുള്ള ഐച്ഛിക ക്രമീകരണങ്ങൾ.

പ്രാമാണീകരണം

അക്കൗണ്ട് API-കൾക്ക് Sulvo API കീ ഉപയോഗിക്കുക

Sulvo ഡാഷ്ബോർഡിലെ അക്കൗണ്ട് ക്രമീകരണങ്ങളിൽ API കീ സൃഷ്ടിക്കുക. Sulvo അക്കൗണ്ട് API അഭ്യർത്ഥനകളിൽ അത് Bearer ടോക്കണായി അയയ്ക്കുക.

Authorization ഹെഡർ

Authorization: Bearer $SULVO_API_KEY

reports:read

റിപ്പോർട്ട് എക്സ്പോർട്ടുകൾക്കും സംരക്ഷിച്ച റിപ്പോർട്ടുകളുടെ പട്ടികയ്ക്കും ആവശ്യമാണ്.

reports:write

വിപുലമായ റിപ്പോർട്ടുകൾ സൃഷ്ടിക്കാനും പുതുക്കാനും പ്രവർത്തിപ്പിക്കാനും ഇല്ലാതാക്കാനും ആവശ്യമാണ്.

inventory:write

പരസ്യ യൂണിറ്റുകൾ സൃഷ്ടിക്കാനും ഇല്ലാതാക്കാനും ആവശ്യമാണ്. അക്കൗണ്ടിന് അംഗീകാരം ലഭിച്ചിരിക്കണം, ഇൻവെന്ററി ആ അക്കൗണ്ടിന്റെ ഉടമസ്ഥതയിലായിരിക്കണം.

റിപ്പോർട്ടുകൾ

റിപ്പോർട്ടുകൾ വായിക്കാനുള്ള എൻഡ്‌പോയിന്റുകൾ

റിപ്പോർട്ടുകൾ വായിക്കാൻ Sulvo അക്കൗണ്ട് API അടിസ്ഥാന പാതയിലെ GET അഭ്യർത്ഥനകൾ ഉപയോഗിക്കുക. തീയതി മാത്രം നൽകിയാൽ, അത് പൂർണ്ണ UTC ദിവസമായി കണക്കാക്കും.

റിപ്പോർട്ട് അഭ്യർത്ഥന

curl "https://surge.sulvo.com/api/v1/reports/by-date?start=2026-06-01&end=2026-06-07&domains=example.com" \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "accept: application/json"

Method	Path	Notes
GET	/api/v1/reports/by-date	ദൈനംദിന പ്രകടന സംഗ്രഹം. തീയതി, ഡൊമെയ്ൻ, പരസ്യ റൂട്ട്, സേവനദാതാവ് എന്നിവ ഉപയോഗിച്ച് ഫിൽട്ടർ ചെയ്യാം.
GET	/api/v1/reports/by-date-and-ad-unit	പരസ്യ യൂണിറ്റ് അനുസരിച്ച് ഗ്രൂപ്പ് ചെയ്ത ദൈനംദിന പ്രകടനം.
GET	/api/v1/reports/by-domain-and-ad-unit	ഡൊമെയ്ൻ, പരസ്യ യൂണിറ്റ് എന്നിവ തിരിച്ചുള്ള പ്രകടന വിശദാംശങ്ങൾ.
GET	/api/v1/reports/bot-filtering	അക്കൗണ്ട് ട്രാഫിക്കിന്റെ ഗുണനിലവാരം അവലോകനം ചെയ്യാനുള്ള ബോട്ട് ഫിൽട്ടറിംഗ് റിപ്പോർട്ട്.
GET	/api/v1/reports/bot-scores	തീയതിയും ബന്ധപ്പെട്ട ഡൈമെൻഷനുകളും അനുസരിച്ചുള്ള ബോട്ട് സ്കോർ റിപ്പോർട്ടിംഗ്.
GET	/api/v1/reports/invalid-activity	അസാധുവായ പ്രവർത്തന റിപ്പോർട്ടിംഗ്. സാധാരണ തീയതി അല്ലെങ്കിൽ ഡൊമെയ്ൻ ക്വറിയുടെ ആവശ്യമില്ല.
GET	/api/v1/reports/direct-bidder-analysis	നേരിട്ടുള്ള ബിഡ്ഡർ റിപ്പോർട്ട്. directBidder ആവശ്യമാണ്; start/end ഉൾപ്പെടുത്താം.
GET	/api/v1/inventory/ad-units-by-domain	ഡൊമെയ്ൻ അനുസരിച്ച് ഗ്രൂപ്പ് ചെയ്ത പരസ്യ യൂണിറ്റ് ഇൻവെന്ററി.

സാധാരണ ക്വറി പാരാമീറ്ററുകൾ: start, end, ആവർത്തിച്ച് നൽകാവുന്ന domains, ആവർത്തിച്ച് നൽകാവുന്ന adRoots, adProvider. നേരിട്ടുള്ള ബിഡ്ഡർ വിശകലനത്തിന് directBidder കൂടി ആവശ്യമാണ്.

വിപുലമായ റിപ്പോർട്ടുകൾ

ഷെഡ്യൂൾ ചെയ്തോ ഉടനെയോ ഇമെയിൽ റിപ്പോർട്ടുകൾ സൃഷ്ടിക്കുക

വിപുലമായ റിപ്പോർട്ടുകൾ ഉടൻ പ്രവർത്തിപ്പിക്കാം, അല്ലെങ്കിൽ ഒരു ഷെഡ്യൂൾ അനുസരിച്ച് ആവർത്തിക്കാം. അവ ഇൻലൈൻ ആയി നൽകാതെ ഇമെയിൽ വഴിയാണ് അയയ്ക്കുന്നത്.

വിപുലമായ റിപ്പോർട്ട് സംരക്ഷിക്കുക

curl -X POST https://surge.sulvo.com/api/v2/reports/save-advanced-report \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "reportType": "dimensions",
    "toAddress": "publisher@example.com",
    "immediateRun": true,
    "domains": ["example.com"],
    "dimensions": ["country", "device"],
    "start": "2026-06-01",
    "end": "2026-06-07"
  }'

Method	Path	Notes
GET	/api/v2/reports/advanced-reports	പ്രാമാണീകരിച്ച അക്കൗണ്ടിനായി സംരക്ഷിച്ച വിപുലമായ റിപ്പോർട്ടുകൾ പട്ടികപ്പെടുത്തുക.
POST	/api/v2/reports/save-advanced-report	വിപുലമായ റിപ്പോർട്ട് സൃഷ്ടിക്കുകയോ പുതുക്കുകയോ ചെയ്യുക. reportType, toAddress, immediateRun, കൂടാതെ കുറഞ്ഞത് ഒരു adRoots അല്ലെങ്കിൽ domains ലക്ഷ്യം ആവശ്യമാണ്.
DELETE	/api/v2/reports/delete-advanced-report/{reportId}	ഒരു സംരക്ഷിച്ച വിപുലമായ റിപ്പോർട്ട് അതിന്റെ id ഉപയോഗിച്ച് ഇല്ലാതാക്കുക.

റിപ്പോർട്ട് തരങ്ങൾ

adUnit, dimensions, customData

ഡൈമെൻഷനുകൾ

country, device, os

ആവൃത്തി

daily, weekly, biweekly, monthly

ഇൻവെന്ററി

അംഗീകൃത പരസ്യ യൂണിറ്റുകൾ സൃഷ്ടിക്കുകയും ഇല്ലാതാക്കുകയും ചെയ്യുക

ഇൻവെന്ററി മാറ്റങ്ങൾക്ക് അംഗീകരിച്ച Sulvo അക്കൗണ്ടും inventory:write സ്കോപ്പ് ഉള്ള ഉടമ സൃഷ്ടിച്ച API കീയും ആവശ്യമാണ്.

പരസ്യ യൂണിറ്റ് സൃഷ്ടിക്കുക

curl -X PUT https://surge.sulvo.com/api/v2/inventory/unit \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "domain": "example.com",
    "type": "display",
    "size": { "width": 300, "height": 250 }
  }'

Method	Path	Notes
PUT	/api/v2/inventory/unit	domain, type, ഐച്ഛിക size, placement, ഇഷ്ടാനുസൃത പേര്, focusedAd ക്രമീകരണങ്ങൾ എന്നിവ ഉപയോഗിച്ച് ഒരു പരസ്യ യൂണിറ്റ് സൃഷ്ടിക്കുക.
PUT	/api/v2/inventory/interstitial-units	ഒരു ഡൊമെയ്‌നിനായി ഡെസ്‌ക്‌ടോപ്പ്, മൊബൈൽ ഇന്റർസ്റ്റീഷ്യൽ യൂണിറ്റുകളോ അവയിലൊന്നോ സൃഷ്ടിക്കുക.
PUT	/api/v2/inventory/auto-sticky-units	ഒരു ഡൊമെയ്‌നിനായി സ്റ്റിക്കി ഡിസ്പ്ലേ, സ്റ്റിക്കി മൊബൈൽ യൂണിറ്റുകളോ അവയിലൊന്നോ സൃഷ്ടിക്കുക.
DELETE	/api/v2/inventory/unit/{adId}	പ്രാമാണീകരിച്ച അക്കൗണ്ടിന്റെ ഉടമസ്ഥതയിലുള്ള പരസ്യ യൂണിറ്റ് ഇല്ലാതാക്കുക.

പിന്തുണയ്ക്കുന്ന പരസ്യ യൂണിറ്റ് തരങ്ങൾ

displaynative_multisticky_displaysticky_mobilesticky_display_customsticky_mobile_customsticky_videointerstitial_desktopinterstitial_mobileofferwall

പിശകുകൾ

പിശകുകൾ കൈകാര്യം ചെയ്യൽ

2xx അല്ലാത്ത ഓഡിറ്റ് പ്രതികരണങ്ങളും Sulvo അക്കൗണ്ട് API പരാജയങ്ങളും ഏജന്റ്, CLI ക്ലയന്റുകൾക്കായി രൂപകൽപ്പന ചെയ്ത JSON ബോഡികൾ നൽകുന്നു.

401

അക്കൗണ്ട് API അഭ്യർത്ഥനകളിൽ API കീ ഇല്ല, അസാധുവാണ്, അല്ലെങ്കിൽ കാലഹരണപ്പെട്ടു. പൊതു ഓഡിറ്റ് എൻഡ്‌പോയിന്റിന് കീ ആവശ്യമില്ല.

403

കീ ഉപയോഗിച്ച് പ്രാമാണീകരണം നടന്നു, പക്ഷേ ആവശ്യമായ സ്കോപ്പ് ഇല്ല, അക്കൗണ്ടിന് അംഗീകാരമില്ല, അല്ലെങ്കിൽ റിസോഴ്സ് മറ്റൊരു അക്കൗണ്ടിന്റേതാണ്.

503 / 504

പൊതു ഓഡിറ്റ് സേവനം അമിതഭാരത്തിലാണ്, അല്ലെങ്കിൽ ഓഡിറ്റ് സമയപരിധി കഴിഞ്ഞു. പിന്നീട് വീണ്ടും ശ്രമിക്കുക; Retry-After ഉണ്ടെങ്കിൽ അത് പാലിക്കുക.

ഓഡിറ്റ് പിശക് ഘടന

{
  "error": {
    "code": "audit_capacity_exceeded",
    "message": "Audit capacity is currently exhausted. Retry later."
  }
}

നിങ്ങൾക്ക് വേണ്ടത് പാക്കേജ് ചെയ്ത ക്ലയന്റാണോ?

npm പാക്കേജും MCP സജ്ജീകരണവും നിങ്ങൾക്കായി ഈ എൻഡ്‌പോയിന്റുകൾ വിളിക്കുന്നു. അനുയോജ്യമായ AI ക്ലയന്റുകൾക്കും അതേ ഓഡിറ്റ്, റിപ്പോർട്ട്, ഇൻവെന്ററി പ്രവർത്തനക്രമങ്ങൾ ലഭ്യമാക്കുന്നു.

സജ്ജീകരണം കാണുക