OLX

OLX Search Suggestions API

The suggestions the OLX search box shows for what a user typed, on any of the seven OLX Europe sites: up to 10 popular searches, each with the category it is most searched in (category_id, name and its parent categories), in the site's language. Use it for keyword research and to map a phrase to the category_id search takes. Costs 1 credit per request.

POST/api/v1/olx/suggestions

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

What the user has typed so far, 1-100 characters.

Example: rower

countryenum<string>default:pl

The OLX site. Titles, parameters and labels come back in the site's language (Polish on pl; Russian by default on kz and uz), prices in its currency. When you send a url, the market follows the url.

Example: pl

pl — olx.pl, PLN, Polish. The default.
ro — olx.ro, RON, Romanian.
pt — olx.pt, EUR, Portuguese.
bg — olx.bg, EUR, Bulgarian.
ua — olx.ua, UAH, Ukrainian.
kz — olx.kz, KZT, Russian by default, Kazakh with language kk.
uz — olx.uz, UZS, Russian by default, Uzbek with language uz.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

for s in client.olx.suggestions(query="rower")["data"]["suggestions"]:
    print(s["text"], "->", s["category_id"], s["category"])

Response

"query": "rower",

"count": 10,

"country": "pl",

"language": "pl",

"currency": "PLN"

"response_time": 3199

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") for s in client.olx.suggestions(query="rower")["data"]["suggestions"]: print(s["text"], "->", s["category_id"], s["category"])