olx-api
OLX API - Listings, Ads, Sellers, 7 OLX Europe Markets
Read OLX classified ads from the seven OLX Europe sites: olx.pl (Poland), olx.ro (Romania), olx.pt (Portugal), olx.bg (Bulgaria), olx.ua (Ukraine), olx.kz (Kazakhstan) and olx.uz (Uzbekistan). Search by keyword and / or category, sorted by relevance, newest or price, filtered by price, condition, private or business seller, OLX delivery, photos, region, city or district with a radius, and by the category's own filters (rooms, area, year, mileage and the rest), which the filters endpoint lists with their values and live counts. Each ad comes with its price in the site's currency, condition, every parameter, category, location with ids, created / refreshed / valid-to dates, the promoted flag with its slot on the page, the business flag and the OLX delivery flag. Read one ad in full by id or link, a seller's business flag, business name, member-since date and number of live ads, and a seller's live ads. Look up the category tree, location ids for the location filters, the suggestions the search box shows, and the ads OLX recommends next to an ad. All 9 endpoints return structured JSON and cost 1 credit each.
Which OLX: this skill covers OLX Europe only, the seven sites above. OLX Brasil (olx.com.br), OLX India (olx.in), OLX Bosnia (olx.ba), olx.co.id and the Dubizzle-run OLX sites (Pakistan, Egypt, Lebanon) are different companies on different platforms and are not covered. If the user means one of those, say so instead of calling this API.
Data comes in the site's language exactly as OLX writes it: Polish titles and parameters on olx.pl ("Używane", "Model telefonu"), Romanian on olx.ro, Portuguese on olx.pt, Bulgarian on olx.bg, Ukrainian on olx.ua, and Russian by default on olx.kz and olx.uz (Kazakh or Uzbek with language). Quote those values as returned; translate them for the user only in your own words around the data, never inside it.
OLX's own API, the OLX Partner API (developer.olx.pl and its sister portals), is a seller-integration API. Its spec says it lets partners "integrate with local sites by posting, managing adverts and communicating with OLX users via internal messaging system", after an OLX user authorizes the app. The developer.olx.pl FAQ answers the read question directly: "Can I use API to read other people ads? It is not possible - you can manage only your own ads added on your authorized OLX account." This skill reads public OLX ads with one Scavio key instead.
Privacy is built in: private sellers come back as an id only. Seller names, phone numbers, emails, exact map positions, last-seen times and car VINs are never returned, and phone numbers and email addresses written into titles and descriptions are replaced with [phone removed] / [email removed]. business_name is filled for business sellers only.
See also: for Allegro, Poland's largest marketplace for new goods, use allegro-api; for second-hand fashion on Vinted (including vinted.pl and vinted.ro) use vinted-api; for eBay listings and sold comps use ebay-product-data.