{"id":19603421,"url":"https://github.com/singer-io/tap-taboola","last_synced_at":"2025-04-27T17:32:49.616Z","repository":{"id":55050864,"uuid":"86844948","full_name":"singer-io/tap-taboola","owner":"singer-io","description":"A Singer tap for extracting data from the Taboola API","archived":false,"fork":false,"pushed_at":"2024-09-03T10:25:23.000Z","size":40,"stargazers_count":2,"open_issues_count":12,"forks_count":12,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-05T02:06:04.489Z","etag":null,"topics":["singer","tap"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/singer-io.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-31T17:39:25.000Z","updated_at":"2024-09-03T10:25:27.000Z","dependencies_parsed_at":"2024-05-28T10:06:08.877Z","dependency_job_id":"5cbf5375-37da-4c31-9208-b0f78a6bccd3","html_url":"https://github.com/singer-io/tap-taboola","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/singer-io%2Ftap-taboola","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/singer-io%2Ftap-taboola/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/singer-io%2Ftap-taboola/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/singer-io%2Ftap-taboola/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/singer-io","download_url":"https://codeload.github.com/singer-io/tap-taboola/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251178110,"owners_count":21548166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["singer","tap"],"created_at":"2024-11-11T09:29:33.127Z","updated_at":"2025-04-27T17:32:49.349Z","avatar_url":"https://github.com/singer-io.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tap-taboola\n\nAuthor: Connor McArthur (connor@fishtownanalytics.com)\n\nThis is a [Singer](https://singer.io) tap that produces JSON-formatted data following the [Singer spec](https://github.com/singer-io/getting-started/blob/master/SPEC.md).\n\nThis tap:\n- Pulls raw data from Taboola's Backstage API\n- Extracts the following resources:\n  - Campaigns\n  - Campaign Reports, specifically the `campaign_day_breakdown` report\n- Outputs the schema for each resource\n- Incrementally pulls data based on the input state\n\n\n## Quick start\n\n1. Install\n\n    ```bash\n    \u003e git clone git@github.com:fishtown-analytics/tap-taboola.git\n    \u003e cd tap-taboola\n    \u003e pip install .\n    ```\n\n2. Get credentials from Taboola:\n\n    You'll need:\n\n    - Your account id (if you aren't sure, contact your account manager)\n    - A Taboola username and password with access to the API\n    - A client ID and secret for the API (your account manager can give you these)\n\n3. Create the config file.\n\n    There is a template you can use at `config.json.example`, just copy it to `config.json`\n    in the repo root and insert your credentials.\n\n    - `account_id`, your Taboola account ID (looks like `taboola­demo­advertiser`).\n    - `username`, your Taboola username -- used to generate an API access key.\n    - `password`, the Taboola password to go along with `username`.\n    - `client_id`, your Taboola client ID. You should reach out to your account manager to get this.\n    - `client_secret`, your Taboola client secret. You should reach out to your account manager to get this.\n    - `start_date`, the date from which you want to sync data, in the format `2017-03-10`.\n\n4. Run the application.\n\n   ```bash\n   tap-taboola --config config.json\n   ```\n\n## Gotchas\n\n- `campaigns`: Taboola pushes `null` for `start_date` and `9999-12-31` for `end_date` sometimes. This tap converts `null` dates to `9999-12-31` for consistency. I don't know what that signifies at present. - @cmcarthur\n\n---\n\nCopyright \u0026copy; 2017 Stitch\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinger-io%2Ftap-taboola","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsinger-io%2Ftap-taboola","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinger-io%2Ftap-taboola/lists"}