--- updatedAt: 2026-10-05T14:17:51.000Z agentTools: projectIndex: https://developers.apptweak.com/llms.txt --- # Keyword Live Search - Current Returns the organic app results of a live search on the store for a given keyword.

You can find historical top apps in the Historical section.

Price
DatapointDescriptionCredits/request
-List of app IDs that rank on that keyword. The list starts with the app that ranks first for the keyword.50
Experiencing a 500 error?

If you're requesting data for a keyword not currently available in AppTweak's database, you may encounter a timeout resulting in a 500 error. We suggest retrying the request a couple of times. Our team is actively working to optimize this behavior to minimize disruptions.

 # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "version": "1", "title": "App Store API", "contact": { "name": "AppTweak", "email": "support@apptweak.com" } }, "servers": [ { "url": "https://public-api.apptweak.com/api/public/store" } ], "security": [ { "api_key": [] } ], "tags": [ { "name": "Keyword Live Search" } ], "paths": { "/keywords/search-results/current": { "get": { "summary": "Keyword Live Search - Current", "description": "Returns the organic app results of a live search on the store for a given keyword.

You can find historical top apps in the Historical section.

Price
DatapointDescriptionCredits/request
-List of app IDs that rank on that keyword. The list starts with the app that ranks first for the keyword.50
Experiencing a 500 error?

If you're requesting data for a keyword not currently available in AppTweak's database, you may encounter a timeout resulting in a 500 error. We suggest retrying the request a couple of times. Our team is actively working to optimize this behavior to minimize disruptions.

", "operationId": "keyword-search-current", "tags": [ "Keyword Live Search" ], "parameters": [ { "name": "keyword", "in": "query", "description": "The keyword to search for. Only one keyword is allowed.", "required": true, "example": "meditation", "schema": { "type": "string" } }, { "name": "country", "in": "query", "description": "Two-letter country code (`us`, `gb`, `fr`). Accepted values: GET /api/public/apptweak/countries with `store=ios` or `store=android`. Defaults to us.", "required": false, "schema": { "default": "us", "type": "string" } }, { "name": "language", "in": "query", "description": "AppTweak language code, not always ISO: US English is `us`, US Spanish `sp`. Accepted pairs: GET /api/public/apptweak/languages with `store=ios` or `store=android`. Defaults to the country's default language.", "required": false, "schema": { "type": "string" } }, { "name": "device", "in": "query", "description": "Choose a device from iphone, ipad or android. Defaults to iphone.", "required": false, "schema": { "default": "iphone", "type": "string", "enum": [ "iphone", "ipad", "android" ] } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "result": { "type": "object", "properties": { "value": { "type": "array", "description": "App IDs ranking on the keyword, best rank first.", "items": { "$ref": "#/components/schemas/AppIdentifier" } }, "date": { "type": "string" } } }, "metadata": { "$ref": "#/components/schemas/ResponseMetadata" } } }, "examples": { "iOS": { "value": { "result": { "value": [ 377889715, 570156001, 883735332, 295079411, 885975369, 1020641417, 1162060359, 1466632533, 555063314, 514921710 ], "date": "2022-03-15" }, "metadata": { "request": { "path": "/api/public/store/keywords/search-results/current", "params": { "device": "iphone", "country": "es", "language": "es", "limit": 10, "offset": 0, "keyword": "rent a car" }, "cost": 51, "max_credit_cost": 51, "status": 200 }, "response": null } } }, "Android": { "value": { "result": { "value": [ "com.rentalcars.handset", "com.sixt.reservation", "com.rental24h.rental24h", "com.clanmo.europcar", "com.rentcars.rentcarscom", "com.ehi.enterprise.android", "com.relayrides.android.relayrides", "com.hertz", "com.localiza.mobile", "com.llollo.bipi" ], "date": "2022-03-15" }, "metadata": { "request": { "path": "/api/public/store/keywords/search-results/current", "params": { "device": "android", "country": "es", "language": "es", "limit": 10, "offset": 0, "keyword": "rent a car" }, "cost": 51, "max_credit_cost": 51, "status": 200 }, "response": null } } } } } } }, "401": { "description": "Unauthorized. Unknown or missing API token." }, "403": { "description": "Forbidden. Not enough credits to perform the request." }, "422": { "description": "Validation error. Returned when a parameter is invalid." } } } } }, "components": { "securitySchemes": { "api_key": { "type": "apiKey", "name": "x-apptweak-key", "in": "header" } }, "schemas": { "AppIdentifier": { "title": "App ID", "description": "An app identifier.", "oneOf": [ { "title": "iOS App Store ID", "type": "integer", "description": "Numeric App Store ID, returned for device iphone or ipad.", "example": 377889715 }, { "title": "Android package name", "type": "string", "description": "Package name, returned for device android.", "example": "com.rentalcars.handset" } ] }, "ResponseMetadata": { "type": "object", "description": "Standard response envelope, identical on every endpoint.", "properties": { "request": { "type": "object", "properties": { "path": { "type": "string", "description": "The path that was called." }, "params": { "type": "object", "nullable": true, "description": "The query as the API parsed it, with defaults applied." }, "cost": { "type": "integer", "description": "Credits actually charged for this call." }, "max_credit_cost": { "type": "integer", "description": "Credits the call could have cost if every datapoint requested had been available." }, "status": { "type": "integer", "description": "HTTP status of the response." } } }, "response": { "type": "object", "nullable": true, "description": "Endpoint-specific notes; null when there are none." } } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```