ShortKit Surveys API
Short polls injected between content items in the feed.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/shortkit-surveys-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: ShortKit Ad Configuration Surveys API
version: v1
description: The ShortKit API lets you manage content, uploads, live streams, surveys, analytics, and ad configuration for your short-form vertical video feeds. It is organized around REST, uses standard HTTP methods, returns JSON wrapped in a standard envelope, and uses conventional HTTP status codes. All requests must be made over HTTPS.
contact:
name: ShortKit
url: https://www.shortkit.dev
x-logo:
url: https://www.shortkit.dev/icon.svg
servers:
- url: https://api.shortkit.dev/v1
description: Production (base URL; environment is selected by the API key prefix — live vs test)
security:
- SecretKey: []
tags:
- name: Surveys
description: Short polls injected between content items in the feed.
paths:
/surveys:
get:
operationId: listSurveys
summary: List Surveys
tags:
- Surveys
responses:
'200':
description: List of surveys.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Survey'
meta:
$ref: '#/components/schemas/Meta'
post:
operationId: createSurvey
summary: Create Survey
tags:
- Surveys
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- question
- options
properties:
title:
type: string
question:
type: string
priority:
type: integer
autoAdvanceDelay:
type: number
options:
type: array
items:
type: object
properties:
text:
type: string
position:
type: integer
responses:
'200':
$ref: '#/components/responses/SurveyEnvelope'
/surveys/{id}:
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
get:
operationId: getSurvey
summary: Get Survey
tags:
- Surveys
responses:
'200':
$ref: '#/components/responses/SurveyEnvelope'
'404':
$ref: '#/components/responses/Error'
put:
operationId: updateSurvey
summary: Update Survey
tags:
- Surveys
requestBody:
content:
application/json:
schema:
type: object
additionalProperties: true
responses:
'200':
$ref: '#/components/responses/SurveyEnvelope'
delete:
operationId: deleteSurvey
summary: Delete Survey
tags:
- Surveys
responses:
'200':
description: Deleted.
/surveys/{id}/responses:
post:
operationId: submitSurveyResponse
summary: Submit Response
description: Submit an end-user response to a survey. Accepts a publishable key.
tags:
- Surveys
security:
- PublishableKey: []
- SecretKey: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- optionId
properties:
optionId:
type: string
format: uuid
responses:
'200':
description: Response recorded.
'409':
$ref: '#/components/responses/Error'
components:
responses:
Error:
description: Error response (standard envelope with errors[]).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
SurveyEnvelope:
description: A single survey.
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Survey'
meta:
$ref: '#/components/schemas/Meta'
schemas:
Survey:
type: object
properties:
id:
type: string
format: uuid
title:
type: string
question:
type: string
status:
type: string
enum:
- draft
- active
- paused
- archived
priority:
type: integer
autoAdvanceDelay:
type: number
options:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
text:
type: string
position:
type: integer
responseCount:
type: integer
createdAt:
type: string
format: date-time
placementRules:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
ruleType:
type: string
example: min_videos_before
ruleValue:
type: object
additionalProperties: true
createdAt:
type: string
format: date-time
totalResponses:
type: integer
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
Meta:
type: object
description: Envelope metadata. Always includes request_id; nextCursor present when more results exist.
properties:
request_id:
type: string
example: req_abc123def456
nextCursor:
type: string
nullable: true
ErrorEnvelope:
type: object
properties:
data:
type: 'null'
meta:
$ref: '#/components/schemas/Meta'
errors:
type: array
items:
type: object
properties:
code:
type: string
enum:
- invalid_request
- invalid_api_key
- forbidden
- not_found
- conflict
- rate_limited
- internal_error
message:
type: string
securitySchemes:
PublishableKey:
type: apiKey
in: header
name: X-API-Key
description: Publishable key (prefix pk_{env}_). Read-only access to published content plus event ingestion and survey-response submission. Safe for client-side/mobile use.
SecretKey:
type: http
scheme: bearer
description: Secret key (prefix sk_{env}_) sent as a Bearer token. Full management access. Server-side only; bcrypt-hashed at rest and shown once at creation.