Media Fetcher

Problem statement

Solution

media-fetcher performs fetching of images and videos performance from various data sources.

Deliverable (implementation)

media-fetcher is implemented as a:

library - Use it in your projects with a help of media_fetching.MediaFetchingService class.
CLI tool - media-fetcher tool is available to be used in the terminal.

Deployment

Prerequisites

Python 3.10+
Google Ads API enabled and configured
YouTube Data API enabled and configured
(Optional) If using tagging modules - media-tagger configured

Installation

Install media-fetcher with pip install media-fetching command.

Usage

Fetching media

Once media-fetcher is installed you can call it:

media-fetcher \
  --source <MEDIA_SOURCE> \
  --media-type <MEDIA_TYPE> \
  --extra_info <EXTRA_INFO_MODULES> \
  --writer <WRITER_TYPE> \
  --output <OUTPUT_FILE_NAME>

where:

<SOURCE> - source of media data:
- googleads - fetch all assets from a Google Ads account / MCC.
- file - fetch all assets with their tags and metrics from CSV files
- youtube - fetch public videos from a YouTube channel.
<MEDIA_TYPE> - type of media (YOUTUBE_VIDEO, VIDEO, IMAGE).
<WRITER_TYPE> - writer identifier (check available options at garf-io library).
<OUTPUT_FILE_NAME> - name of the file to store results of tagging (by default media_results).

Source customizations

Source customizations are performed via --source.parameters=value syntax (i.e. --googleads.account=1)

googleads:

Mandatory:
- account=ACCOUNT_ID
Optional:
- ads_config_path=PATH-TO-GOOGLE-ADS-YAML
- campaign-types=CAMPAIGN_TYPE
- start-date=YYYY-MM-DD
- end-date=YYYY-MM-DD
youtube:

Mandatory:
- channel=YOUTUBE_CHANNEL_ID
file:

Mandatory:
- path=PATH_TO_FILE
Optional:
- media_identifier=IDENTIFIER_OF_MEDIA
- metric_names=COMMA_SEPARATED_METRIC_NAMES
bq:

Mandatory:
- table=FULLY_QUALIFIED_TABLE_NAME (in project.dataset.table format)
Optional:
- media_identifier=IDENTIFIER_OF_MEDIA
- metric_names=COMMA_SEPARATED_METRIC_NAMES
sqldb:

Mandatory:
- connection_string=DATABASE_CONNECTION_STRING (in SQLAlchemy format)
- table=TABLE_NAME
Optional:
- media_identifier=IDENTIFIER_OF_MEDIA
- metric_names=COMMA_SEPARATED_METRIC_NAMES

Available extra info modules

Source customizations are performed via --extra-info module.method syntax (i.e. --extra-info tagging.languages,googleads.main_geo)

Currently supported modules:

googleads:
- main_geo - identifies main spending country for a media.
- approval_rate - calculates approval rate (from 0 to 1) for each media.
tagging:
- language - identifies language of a media.
youtube:
- language - identifies language of YouTube Video based on YouTube Data API.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

media_fetching-0.6.5.tar.gz (21.6 kB view details)

Uploaded Aug 31, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

media_fetching-0.6.5-py3-none-any.whl (37.3 kB view details)

Uploaded Aug 31, 2026 Python 3

File details

Details for the file media_fetching-0.6.5.tar.gz.

File metadata

Download URL: media_fetching-0.6.5.tar.gz
Upload date: Aug 31, 2026
Size: 21.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for media_fetching-0.6.5.tar.gz
Algorithm	Hash digest
SHA256	`159af938d08c69fd0139b566bf01a1033df036d3105891a9c30bddebbd250570`
MD5	`6812377702c572d0065fa812df569867`
BLAKE2b-256	`0204a73958b5c8315825506a02165db4803b06d267b2401b9dd5fec499ccc766`

See more details on using hashes here.

File details

Details for the file media_fetching-0.6.5-py3-none-any.whl.

File metadata

Download URL: media_fetching-0.6.5-py3-none-any.whl
Upload date: Aug 31, 2026
Size: 37.3 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for media_fetching-0.6.5-py3-none-any.whl
Algorithm	Hash digest
SHA256	`ee3f071a717f21045c40f34e8f88a256fd625a56b996a8f2979f49f26ab206f8`
MD5	`d4edb5f1de052fbb4b60c99c7b2ff374`
BLAKE2b-256	`da159e95bb5b5154f352fabc41e4497aa239af903a8fde7fe9374135d01a96b8`