OLX Scraper Documentation

Overview

The OLX Scraper is an Apify actor designed to scrape detailed information from olx.com. This tool is ideal for users looking to extract data about specific items, such as mobile phones, within specified price ranges and other parameters.

Input Configuration

The scraper accepts the following JSON input:

{
  "item_limit": 10,
  "price_max": 50000,
  "price_min": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "query": "mobile phone"
}

Input Fields

• item_limit: (Number) The maximum number of items to scrape. Default is 10.
• price_max: (Number) The upper limit for the price filter. Only items priced below or equal to this value will be retrieved.
• price_min: (Number) The lower limit for the price filter. Only items priced above or equal to this value will be retrieved.
• proxyConfiguration: (Object) Configuration for proxy usage. Set useApifyProxy to true to use the Apify Proxy, or false to disable it.
• query: (String) The search keyword or phrase to look for (e.g., "mobile phone").

Output Format

The actor returns results in the following JSON structure:

[
    {
        "id": "1792974206",
        "title": "Taj Mobiles Seconds Mobile Available in Best Price Indira nagar",
        "body_type": null,
        "user_type": "Regular",
        "image": [
            "https://apollo.olx.in:443/v1/files/9eedd4arefq02-IN/image",
            "https://apollo.olx.in:443/v1/files/5oav3992np342-IN/image",
            "https://apollo.olx.in:443/v1/files/1uemrs5d63le1-IN/image",
            "https://apollo.olx.in:443/v1/files/2s1iveb7b2bi1-IN/image",
            "https://apollo.olx.in:443/v1/files/wj46j39m37od1-IN/image"
        ],
        "price": {
            "value": {
                "raw": 7000,
                "currency": {
                    "iso_4217": "INR",
                    "pre": "₹"
                },
                "display": "₹ 7,000"
            },
            "key_name": "Price",
            "key": "price"
        },
        "location": "Karnataka",
        "description": "All Android Models Available in Best Price\nAnd I phone's Available.\nWe buy Mobile an sale.\nNo refurbished mobiles.\nBest offer's will provide \nShop Name Taj mobile world Indira Nagar \nBangalore.",
        "created_at": "2024-12-17T19:25:57+05:30",
        "certified": false,
        "kyc_verified_user": false,
        "KM_run": null,
        "parameters": [
            {
                "type": "single",
                "key": "make",
                "value_name": "Vivo",
                "value": "vivo-phone",
                "key_name": "Brand",
                "formatted_value": "Vivo"
            }
        ]
    }
]

Output Fields

• id: (String) Unique identifier for the listing.
• title: (String) Title of the listing.
• body_type: (String) Type of body (if applicable).
• user_type: (String) Type of user posting the ad (e.g., Regular, Dealer).
• image: (Array) URLs of images associated with the listing.
• price: (Object) Details about the price, including currency and display format.
• location: (String) Location of the listing.
• description: (String) Description of the listing.
• created_at: (String) Date and time when the listing was created.
• certified: (Boolean) Indicates if the listing is certified.
• kyc_verified_user: (Boolean) Indicates if the user is KYC-verified.
• KM_run: (Number) Kilometers run (if applicable).
• parameters: (Array) Additional parameters such as brand or model.

Support

For customized outputs or bug reports, please contact us at hello.datawizard@gmail.com. When reaching out, ensure the subject line specifies the nature of your request (e.g., "Custom Output Request" or "Bug Report").

Thank you for using the OLX Scraper!