Smalk Docs
  • Publisher
  • API Reference
  • Smalk MCP
  • Advertiser
Smalk
  • Website
  • Dashboard
  • Service status
Developers
  • REST API reference
  • OpenAPI schema
  • Support
Legal
  • Privacy policy
  • Terms

© 2026 Smalk. All rights reserved.

Information
Tracking
GEA - Ad Content
Ad Placement Inventory
Workspace
Health
IndexNow
Reporting
Datasets
    /api/v1/public/datasets/{dataset_id}/get/api/v1/public/datasets/{dataset_id}/responses/post/api/v1/public/workspaces/{workspace_id}/datasets/get/api/v1/public/workspaces/{workspace_id}/datasets/{dataset_id}/get
public
Schemas
powered by Zudoku
Smalk Public API
Smalk Public API

Datasets


GET
https://api.smalk.ai
/api/v1/public/datasets/{dataset_id}/

GET nested /workspaces/{ws}/datasets/{id}/ AND flat /datasets/{id}/.

path Parameters

dataset_id
​string · uuid · required

Responses

200

No response body

No data returned
GET/api/v1/public/datasets/{dataset_id}/
curl https://api.smalk.ai/api/v1/public/datasets/:dataset_id \ --header 'Authorization: <api-key>'
Example Responses
No example specified for this content type

POST
https://api.smalk.ai
/api/v1/public/datasets/{dataset_id}/responses/

POST /api/v1/public/datasets/{dataset_id}/responses/ — partner raw-answer push.

Records (spec §6ter): prompt_id (partner id ↔ CampaignQuery.provider_external_id), platform, model?, run_at, run_index, answer_text, citations[], sources[]?. Idempotent on (prompt_id, platform, run_at, run_index) via raw_answer["partner_ingest_key"] (same dedupe pattern as the external-import path).

path Parameters

dataset_id
​string · uuid · required

Responses

200

No response body

No data returned
POST/api/v1/public/datasets/{dataset_id}/responses/
curl https://api.smalk.ai/api/v1/public/datasets/:dataset_id/responses \ --request POST \ --header 'Authorization: <api-key>'
Example Responses
No example specified for this content type

GET
https://api.smalk.ai
/api/v1/public/workspaces/{workspace_id}/datasets/

GET /api/v1/public/workspaces/{workspace_id}/datasets/

path Parameters

workspace_id
​string · uuid · required

Responses

200

No response body

No data returned
GET/api/v1/public/workspaces/{workspace_id}/datasets/
curl https://api.smalk.ai/api/v1/public/workspaces/:workspace_id/datasets \ --header 'Authorization: <api-key>'
Example Responses
No example specified for this content type

GET
https://api.smalk.ai
/api/v1/public/workspaces/{workspace_id}/datasets/{dataset_id}/

GET nested /workspaces/{ws}/datasets/{id}/ AND flat /datasets/{id}/.

path Parameters

dataset_id
​string · uuid · required
workspace_id
​string · uuid · required

Responses

200

No response body

No data returned
GET/api/v1/public/workspaces/{workspace_id}/datasets/{dataset_id}/
curl https://api.smalk.ai/api/v1/public/workspaces/:workspace_id/datasets/:dataset_id \ --header 'Authorization: <api-key>'
Example Responses
No example specified for this content type

Reportingpublic