File name templating

By default, result files delivered to your cloud storage use the {{ job_id }}.{{ extension }} naming template (e.g., 7346445033316311041.json). You can specify a custom file naming template for results delivered to your cloud storage.

Here's why you may want to do it:

  • The result file names can be more informative

  • Results can be automatically organized into different directories.

Template variables

You can use any input parameter you provide when creating a job, as well as any variable from the job_info object (found at the bottom of your result) in your file naming template.

Usage

Example 1: Custom file name with multiple variables

# Writes the result to `oxylabs.test/google_search_test_7336001481897673729.json`
{
    "source": "google_search",
    "query": "test",
    "storage_type": "s3",
    "storage_url": "oxylabs.test/{{ source }}_{{ query }}_{{ job_id }}.{{ extension }}"
}

Example 2: Directory organization

# Writes the result to `oxylabs.test/google_search/7336001481897673729.json`
{
    "source": "google_search",
    "query": "test",
    "storage_type": "s3",
    "storage_url": "oxylabs.test/{{ source }}/"
}

Example 3: Custom directory with custom file name

# Writes the result to `oxylabs.test/google_search/oxylabs_test_7336001481897673729.json`
{
    "source": "google_search"
    "query": "test",
    "storage_type": "s3",
    "storage_url": "oxylabs.test/{{ source }}/oxylabs_{{ query }}_{{ job_id }}.{{ extension }}"
}

Last updated

Was this helpful?