Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Appskyline Com Keywords API
version: 1.0.0
x-api-versioning:
currentVersion: '1'
requestHeader: API-Version
responseHeader: API-Version
compatibilityPolicy: Omitting API-Version selects version 1. Unsupported versions return HTTP 400 with supportedVersions.
deprecationPolicy: AppSkyline announces incompatible versions at least 180 days before removal. Deprecated responses include Deprecation, Sunset, and a Link relation named deprecation.
deprecationHeaders:
- Deprecation
- Sunset
- Link
policyUrl: https://www.appskyline.com/api.md#compatibility-version
description: 'Operations tagged Keywords across 2 of this provider''s published API definitions: appskyline-api.swagger.json, appskyline-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.appskyline.com
tags:
- name: Keywords
paths:
/api/keywords:
get:
tags:
- Keywords
summary: List keywords
description: Lists the tracked keywords of your organization, optionally filtered by `appId`. Requires the `keywords:read` scope. For stable traversal, set `pagination=cursor`; the response becomes `{items, nextCursor}` and is ordered by `_id`. Pass `nextCursor` back as `cursor` until it is null. The default array response and offset pagination remain unchanged when cursor pagination is not requested.
security:
- apiKey: []
- accessToken: []
parameters:
- in: query
name: appId
schema:
type: string
- in: query
name: pagination
description: Set to `cursor` for a stable page envelope
schema:
type: string
enum:
- cursor
- in: query
name: cursor
description: Opaque `nextCursor` from the preceding cursor page
schema:
type: string
- in: query
name: limit
description: Page size. Cursor mode defaults to 100 rows and caps at 500; the default array mode keeps 0 as unbounded.
schema:
type: integer
default: 0
- in: query
name: skip
schema:
type: integer
default: 0
- in: query
name: sortField
schema:
type: string
- in: query
name: sortDirection
schema:
type: string
enum:
- ASC
- DESC
- in: query
name: fields
description: Comma-separated projection of fields to return
schema:
type: string
responses:
'200':
description: Array of keywords, or `{items, nextCursor}` in cursor mode
'400':
description: Malformed cursor, or a sort incompatible with cursor pagination
'401':
description: Missing or invalid credentials
'403':
description: API key is missing the `keywords:read` scope
'429':
description: API key rate limit exceeded
operationId: getApiKeywords
x-codeSamples:
- lang: Node + Request
source: "const request = require('request');\n\nconst options = {\n method: 'GET',\n url: 'https://api.appskyline.com/api/keywords',\n qs: {\n appId: 'SOME_STRING_VALUE',\n pagination: 'SOME_STRING_VALUE',\n cursor: 'SOME_STRING_VALUE',\n limit: 'SOME_INTEGER_VALUE',\n skip: 'SOME_INTEGER_VALUE',\n sortField: 'SOME_STRING_VALUE',\n sortDirection: 'SOME_STRING_VALUE',\n fields: 'SOME_STRING_VALUE'\n },\n headers: {Authorization: 'Basic REPLACE_BASIC_AUTH'}\n};\n\nrequest(options, function (error, response, body) {\n if (error) throw new Error(error);\n\n console.log(body);\n});\n"
- lang: Shell + Curl
source: "curl --request GET \\\n --url 'https://api.appskyline.com/api/keywords?appId=SOME_STRING_VALUE&pagination=SOME_STRING_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE&skip=SOME_INTEGER_VALUE&sortField=SOME_STRING_VALUE&sortDirection=SOME_STRING_VALUE&fields=SOME_STRING_VALUE' \\\n --header 'Authorization: Basic REPLACE_BASIC_AUTH'"
- lang: Shell + Httpie
source: "http GET 'https://api.appskyline.com/api/keywords?appId=SOME_STRING_VALUE&pagination=SOME_STRING_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE&skip=SOME_INTEGER_VALUE&sortField=SOME_STRING_VALUE&sortDirection=SOME_STRING_VALUE&fields=SOME_STRING_VALUE' \\\n Authorization:'Basic REPLACE_BASIC_AUTH'"
- lang: Python + Python3
source: 'import http.client
conn = http.client.HTTPSConnection("api.appskyline.com")
headers = { ''Authorization'': "Basic REPLACE_BASIC_AUTH" }
conn.request("GET", "/api/keywords?appId=SOME_STRING_VALUE&pagination=SOME_STRING_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE&skip=SOME_INTEGER_VALUE&sortField=SOME_STRING_VALUE&sortDirection=SOME_STRING_VALUE&fields=SOME_STRING_VALUE", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))'
- lang: Php + Curl
source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n CURLOPT_URL => \"https://api.appskyline.com/api/keywords?appId=SOME_STRING_VALUE&pagination=SOME_STRING_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE&skip=SOME_INTEGER_VALUE&sortField=SOME_STRING_VALUE&sortDirection=SOME_STRING_VALUE&fields=SOME_STRING_VALUE\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_ENCODING => \"\",\n CURLOPT_MAXREDIRS => 10,\n CURLOPT_TIMEOUT => 30,\n CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n CURLOPT_CUSTOMREQUEST => \"GET\",\n CURLOPT_HTTPHEADER => [\n \"Authorization: Basic REPLACE_BASIC_AUTH\"\n ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n}"
- lang: Php + Http1
source: "<?php\n\n$request = new HttpRequest();\n$request->setUrl('https://api.appskyline.com/api/keywords');\n$request->setMethod(HTTP_METH_GET);\n\n$request->setQueryData([\n 'appId' => 'SOME_STRING_VALUE',\n 'pagination' => 'SOME_STRING_VALUE',\n 'cursor' => 'SOME_STRING_VALUE',\n 'limit' => 'SOME_INTEGER_VALUE',\n 'skip' => 'SOME_INTEGER_VALUE',\n 'sortField' => 'SOME_STRING_VALUE',\n 'sortDirection' => 'SOME_STRING_VALUE',\n 'fields' => 'SOME_STRING_VALUE'\n]);\n\n$request->setHeaders([\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\ntry {\n $response = $request->send();\n\n echo $response->getBody();\n} catch (HttpException $ex) {\n echo $ex;\n}"
- lang: Php + Http2
source: "<?php\n\n$client = new http\\Client;\n$request = new http\\Client\\Request;\n\n$request->setRequestUrl('https://api.appskyline.com/api/keywords');\n$request->setRequestMethod('GET');\n$request->setQuery(new http\\QueryString([\n 'appId' => 'SOME_STRING_VALUE',\n 'pagination' => 'SOME_STRING_VALUE',\n 'cursor' => 'SOME_STRING_VALUE',\n 'limit' => 'SOME_INTEGER_VALUE',\n 'skip' => 'SOME_INTEGER_VALUE',\n 'sortField' => 'SOME_STRING_VALUE',\n 'sortDirection' => 'SOME_STRING_VALUE',\n 'fields' => 'SOME_STRING_VALUE'\n]));\n\n$request->setHeaders([\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$client->enqueue($request)->send();\n$response = $client->getResponse();\n\necho $response->getBody();"
post:
tags:
- Keywords
summary: Create a keyword
description: Requires the `keywords:write` scope.
security:
- apiKey: []
- accessToken: []
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'200':
description: The created keyword
'403':
description: API key is missing the `keywords:write` scope
operationId: postApiKeywords
x-codeSamples:
- lang: Node + Request
source: "const request = require('request');\n\nconst options = {\n method: 'POST',\n url: 'https://api.appskyline.com/api/keywords',\n headers: {'content-type': 'application/json', Authorization: 'Basic REPLACE_BASIC_AUTH'},\n body: {},\n json: true\n};\n\nrequest(options, function (error, response, body) {\n if (error) throw new Error(error);\n\n console.log(body);\n});\n"
- lang: Shell + Curl
source: "curl --request POST \\\n --url https://api.appskyline.com/api/keywords \\\n --header 'Authorization: Basic REPLACE_BASIC_AUTH' \\\n --header 'content-type: application/json' \\\n --data '{}'"
- lang: Shell + Httpie
source: "echo '{}' | \\\n http POST https://api.appskyline.com/api/keywords \\\n Authorization:'Basic REPLACE_BASIC_AUTH' \\\n content-type:application/json"
- lang: Python + Python3
source: "import http.client\n\nconn = http.client.HTTPSConnection(\"api.appskyline.com\")\n\npayload = \"{}\"\n\nheaders = {\n 'content-type': \"application/json\",\n 'Authorization': \"Basic REPLACE_BASIC_AUTH\"\n }\n\nconn.request(\"POST\", \"/api/keywords\", payload, headers)\n\nres = conn.getresponse()\ndata = res.read()\n\nprint(data.decode(\"utf-8\"))"
- lang: Php + Curl
source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n CURLOPT_URL => \"https://api.appskyline.com/api/keywords\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_ENCODING => \"\",\n CURLOPT_MAXREDIRS => 10,\n CURLOPT_TIMEOUT => 30,\n CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n CURLOPT_CUSTOMREQUEST => \"POST\",\n CURLOPT_POSTFIELDS => \"{}\",\n CURLOPT_HTTPHEADER => [\n \"Authorization: Basic REPLACE_BASIC_AUTH\",\n \"content-type: application/json\"\n ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n}"
- lang: Php + Http1
source: "<?php\n\n$request = new HttpRequest();\n$request->setUrl('https://api.appskyline.com/api/keywords');\n$request->setMethod(HTTP_METH_POST);\n\n$request->setHeaders([\n 'content-type' => 'application/json',\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$request->setBody('{}');\n\ntry {\n $response = $request->send();\n\n echo $response->getBody();\n} catch (HttpException $ex) {\n echo $ex;\n}"
- lang: Php + Http2
source: "<?php\n\n$client = new http\\Client;\n$request = new http\\Client\\Request;\n\n$body = new http\\Message\\Body;\n$body->append('{}');\n\n$request->setRequestUrl('https://api.appskyline.com/api/keywords');\n$request->setRequestMethod('POST');\n$request->setBody($body);\n\n$request->setHeaders([\n 'content-type' => 'application/json',\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$client->enqueue($request)->send();\n$response = $client->getResponse();\n\necho $response->getBody();"
servers:
- url: https://api.appskyline.com
/api/keywords/{keywordId}:
get:
tags:
- Keywords
summary: Get a keyword by id
description: Requires the `keywords:read` scope.
security:
- apiKey: []
- accessToken: []
parameters:
- in: path
name: keywordId
required: true
schema:
type: string
responses:
'200':
description: The keyword
'403':
description: API key is missing the `keywords:read` scope
'404':
description: No such keyword in your organization
operationId: getApiKeywordsKeywordId
x-codeSamples:
- lang: Node + Request
source: "const request = require('request');\n\nconst options = {\n method: 'GET',\n url: 'https://api.appskyline.com/api/keywords/%7BkeywordId%7D',\n headers: {Authorization: 'Basic REPLACE_BASIC_AUTH'}\n};\n\nrequest(options, function (error, response, body) {\n if (error) throw new Error(error);\n\n console.log(body);\n});\n"
- lang: Shell + Curl
source: "curl --request GET \\\n --url https://api.appskyline.com/api/keywords/%7BkeywordId%7D \\\n --header 'Authorization: Basic REPLACE_BASIC_AUTH'"
- lang: Shell + Httpie
source: "http GET https://api.appskyline.com/api/keywords/%7BkeywordId%7D \\\n Authorization:'Basic REPLACE_BASIC_AUTH'"
- lang: Python + Python3
source: 'import http.client
conn = http.client.HTTPSConnection("api.appskyline.com")
headers = { ''Authorization'': "Basic REPLACE_BASIC_AUTH" }
conn.request("GET", "/api/keywords/%7BkeywordId%7D", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))'
- lang: Php + Curl
source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n CURLOPT_URL => \"https://api.appskyline.com/api/keywords/%7BkeywordId%7D\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_ENCODING => \"\",\n CURLOPT_MAXREDIRS => 10,\n CURLOPT_TIMEOUT => 30,\n CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n CURLOPT_CUSTOMREQUEST => \"GET\",\n CURLOPT_HTTPHEADER => [\n \"Authorization: Basic REPLACE_BASIC_AUTH\"\n ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n}"
- lang: Php + Http1
source: "<?php\n\n$request = new HttpRequest();\n$request->setUrl('https://api.appskyline.com/api/keywords/%7BkeywordId%7D');\n$request->setMethod(HTTP_METH_GET);\n\n$request->setHeaders([\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\ntry {\n $response = $request->send();\n\n echo $response->getBody();\n} catch (HttpException $ex) {\n echo $ex;\n}"
- lang: Php + Http2
source: "<?php\n\n$client = new http\\Client;\n$request = new http\\Client\\Request;\n\n$request->setRequestUrl('https://api.appskyline.com/api/keywords/%7BkeywordId%7D');\n$request->setRequestMethod('GET');\n$request->setHeaders([\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$client->enqueue($request)->send();\n$response = $client->getResponse();\n\necho $response->getBody();"
put:
tags:
- Keywords
summary: Update a keyword
description: Requires the `keywords:write` scope.
security:
- apiKey: []
- accessToken: []
parameters:
- in: path
name: keywordId
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'200':
description: The updated keyword
'404':
description: No such keyword in your organization
operationId: putApiKeywordsKeywordId
x-codeSamples:
- lang: Node + Request
source: "const request = require('request');\n\nconst options = {\n method: 'PUT',\n url: 'https://api.appskyline.com/api/keywords/%7BkeywordId%7D',\n headers: {'content-type': 'application/json', Authorization: 'Basic REPLACE_BASIC_AUTH'},\n body: {},\n json: true\n};\n\nrequest(options, function (error, response, body) {\n if (error) throw new Error(error);\n\n console.log(body);\n});\n"
- lang: Shell + Curl
source: "curl --request PUT \\\n --url https://api.appskyline.com/api/keywords/%7BkeywordId%7D \\\n --header 'Authorization: Basic REPLACE_BASIC_AUTH' \\\n --header 'content-type: application/json' \\\n --data '{}'"
- lang: Shell + Httpie
source: "echo '{}' | \\\n http PUT https://api.appskyline.com/api/keywords/%7BkeywordId%7D \\\n Authorization:'Basic REPLACE_BASIC_AUTH' \\\n content-type:application/json"
- lang: Python + Python3
source: "import http.client\n\nconn = http.client.HTTPSConnection(\"api.appskyline.com\")\n\npayload = \"{}\"\n\nheaders = {\n 'content-type': \"application/json\",\n 'Authorization': \"Basic REPLACE_BASIC_AUTH\"\n }\n\nconn.request(\"PUT\", \"/api/keywords/%7BkeywordId%7D\", payload, headers)\n\nres = conn.getresponse()\ndata = res.read()\n\nprint(data.decode(\"utf-8\"))"
- lang: Php + Curl
source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n CURLOPT_URL => \"https://api.appskyline.com/api/keywords/%7BkeywordId%7D\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_ENCODING => \"\",\n CURLOPT_MAXREDIRS => 10,\n CURLOPT_TIMEOUT => 30,\n CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n CURLOPT_CUSTOMREQUEST => \"PUT\",\n CURLOPT_POSTFIELDS => \"{}\",\n CURLOPT_HTTPHEADER => [\n \"Authorization: Basic REPLACE_BASIC_AUTH\",\n \"content-type: application/json\"\n ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n}"
- lang: Php + Http1
source: "<?php\n\n$request = new HttpRequest();\n$request->setUrl('https://api.appskyline.com/api/keywords/%7BkeywordId%7D');\n$request->setMethod(HTTP_METH_PUT);\n\n$request->setHeaders([\n 'content-type' => 'application/json',\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$request->setBody('{}');\n\ntry {\n $response = $request->send();\n\n echo $response->getBody();\n} catch (HttpException $ex) {\n echo $ex;\n}"
- lang: Php + Http2
source: "<?php\n\n$client = new http\\Client;\n$request = new http\\Client\\Request;\n\n$body = new http\\Message\\Body;\n$body->append('{}');\n\n$request->setRequestUrl('https://api.appskyline.com/api/keywords/%7BkeywordId%7D');\n$request->setRequestMethod('PUT');\n$request->setBody($body);\n\n$request->setHeaders([\n 'content-type' => 'application/json',\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$client->enqueue($request)->send();\n$response = $client->getResponse();\n\necho $response->getBody();"
delete:
tags:
- Keywords
summary: Delete a keyword
description: Requires the `keywords:write` scope.
security:
- apiKey: []
- accessToken: []
parameters:
- in: path
name: keywordId
required: true
schema:
type: string
responses:
'200':
description: Deleted
'404':
description: No such keyword in your organization
operationId: deleteApiKeywordsKeywordId
x-codeSamples:
- lang: Node + Request
source: "const request = require('request');\n\nconst options = {\n method: 'DELETE',\n url: 'https://api.appskyline.com/api/keywords/%7BkeywordId%7D',\n headers: {Authorization: 'Basic REPLACE_BASIC_AUTH'}\n};\n\nrequest(options, function (error, response, body) {\n if (error) throw new Error(error);\n\n console.log(body);\n});\n"
- lang: Shell + Curl
source: "curl --request DELETE \\\n --url https://api.appskyline.com/api/keywords/%7BkeywordId%7D \\\n --header 'Authorization: Basic REPLACE_BASIC_AUTH'"
- lang: Shell + Httpie
source: "http DELETE https://api.appskyline.com/api/keywords/%7BkeywordId%7D \\\n Authorization:'Basic REPLACE_BASIC_AUTH'"
- lang: Python + Python3
source: 'import http.client
conn = http.client.HTTPSConnection("api.appskyline.com")
headers = { ''Authorization'': "Basic REPLACE_BASIC_AUTH" }
conn.request("DELETE", "/api/keywords/%7BkeywordId%7D", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))'
- lang: Php + Curl
source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n CURLOPT_URL => \"https://api.appskyline.com/api/keywords/%7BkeywordId%7D\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_ENCODING => \"\",\n CURLOPT_MAXREDIRS => 10,\n CURLOPT_TIMEOUT => 30,\n CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n CURLOPT_CUSTOMREQUEST => \"DELETE\",\n CURLOPT_HTTPHEADER => [\n \"Authorization: Basic REPLACE_BASIC_AUTH\"\n ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n}"
- lang: Php + Http1
source: "<?php\n\n$request = new HttpRequest();\n$request->setUrl('https://api.appskyline.com/api/keywords/%7BkeywordId%7D');\n$request->setMethod(HTTP_METH_DELETE);\n\n$request->setHeaders([\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\ntry {\n $response = $request->send();\n\n echo $response->getBody();\n} catch (HttpException $ex) {\n echo $ex;\n}"
- lang: Php + Http2
source: "<?php\n\n$client = new http\\Client;\n$request = new http\\Client\\Request;\n\n$request->setRequestUrl('https://api.appskyline.com/api/keywords/%7BkeywordId%7D');\n$request->setRequestMethod('DELETE');\n$request->setHeaders([\n 'Authorization' => 'Basic REPLACE_BASIC_AUTH'\n]);\n\n$client->enqueue($request)->send();\n$response = $client->getResponse();\n\necho $response->getBody();"
servers:
- url: https://api.appskyline.com
components:
headers:
Deprecation:
description: Present only when this API operation or version is deprecated. The value is an RFC 9745 Structured Field Date.
schema:
type: string
example: '@1893456000'
DeprecationLink:
description: Present on deprecated responses and points to the applicable migration or deprecation policy with rel="deprecation".
schema:
type: string
example: <https://www.appskyline.com/api.md#compatibility-version>; rel="deprecation"
Sunset:
description: Present on deprecated responses when a retirement date is scheduled. The value is an HTTP-date.
schema:
type: string
example: Tue, 01 Jan 2030 00:00:00 GMT
schemas:
Error:
type: object
description: Structured JSON API error.
required:
- name
- message
- status
properties:
name:
type: string
message:
type: string
status:
type: integer
details:
type: object
additionalProperties: true
Keyword:
type: object
required:
- _id
- organizationId
- appId
- searchTerms
properties:
_id:
type: string
organizationId:
type: string
appId:
type: string
searchTerms:
type: string
country:
type: string
language:
type: string
rank:
type:
- integer
- 'null'
additionalProperties: true
KeywordPage:
type: object
required:
- items
- nextCursor
properties:
items:
type: array
items:
$ref: '#/components/schemas/Keyword'
nextCursor:
type:
- string
- 'null'
description: Opaque cursor for the next page, or null after the final page
additionalProperties: false
securitySchemes:
apiKey:
type: http
scheme: basic
description: 'HTTP Basic auth carrying only the API key secret: `Authorization: Basic base64(<key secret>)`.'
accessToken:
type: apiKey
in: header
name: Authorization
description: 'Operator session token issued by the Appskyline dashboard: `Authorization: Token <access token>`.'
x-refined-from:
- appskyline-api.swagger.json
- appskyline-com-openapi.json