Skip to content
Back to search

datapika

MarketplaceWorks with Claude CodeGitHub

Working examples (curl, Python, Node.js) and MCP configs for the Datapika web data APIs on Apify: jobs, Reddit, TikTok, reviews, ads, maps and travel.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lnvestor--datapika-examples/badge.svg)](/listings/lnvestor--datapika-examples)

HTML

<a href="/listings/lnvestor--datapika-examples"><img src="/api/listings/lnvestor--datapika-examples/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Create an Apify account at [console.apify.com/sign-up](https://console.apify.com/sign-up). A free account is enough to start. 2. Copy your API token from **Settings > API & Integrations** ([console.apify.com/settings/integrations](https://console.apify.com/settings/integrations)) and put it in an environment variable:

   export APIFY_TOKEN=<your Apify API token>

3. Clone the repository and install the clients you want to use:

   git clone https://github.com/lnvestor/datapika-examples.git
   cd datapika-examples

   python -m pip install -r requirements.txt   # Python 3.11 or newer
   npm install                                 # Node.js 20 or newer

4. Run an example from the repository root:

   ./google-maps-scraper/curl.sh
   python google-maps-scraper/python/run.py
   node google-maps-scraper/node/run.mjs

The Python and Node.js scripts stream the run log, print one line per result and save every row to `output.json` in the current folder.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines
  1. {
  2. "name": "datapika",
  3. "owner": {
  4. "name": "Datapika",
  5. "url": "https://datapika.com"
  6. },
  7. "metadata": {
  8. "description": "Live public web data for agents: jobs, Reddit, TikTok, reviews, ads, maps, flights and stays.",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "datapika",
  14. "source": "./plugins/datapika",
  15. "description": "Datapika skill plus the Datapika MCP server: 19 web data actors (jobs, Reddit, TikTok, YouTube, Trustpilot, Meta and Google ads, Google Maps, Airbnb, flights, hotels) your agent can run and pay per result.",
  16. "category": "data",
  17. "homepage": "https://datapika.com/agents"
  18. }
  19. ]
  20. }
README.md · README · 168 lines
  1. # Datapika examples
  2. Working code examples for the [Datapika](https://datapika.com) web data APIs, which run on [Apify](https://apify.com). Each API is an Apify actor published by `openclawai`: you send a JSON input, it collects public web data, and you read the results as JSON, CSV or Excel.
  3. The examples cover jobs, Reddit, TikTok, Douyin and Bilibili, Trustpilot reviews, the Meta Ad Library, Google Ads Transparency, Google Maps, Airbnb, Google Flights and hotels.
  4. Every actor folder has the same layout:
  5. | File | What it is |
  6. |---|---|
  7. | `curl.sh` | One synchronous REST request that returns the rows as JSON |
  8. | `python/run.py` | The official Python client, [`apify-client`](https://pypi.org/project/apify-client/) |
  9. | `node/run.mjs` | The official JavaScript client, [`apify-client`](https://www.npmjs.com/package/apify-client) |
  10. | `README.md` | The input used, other useful inputs, and the output fields |
  11. | `sample-output.json` | The first two rows of a real run, with personal fields redacted |
  12. Every Python example was run against the live actor on 2026-11-20 before it was published here.
  13. ## Actors
  14. | Actor | What you get | Examples | Actor page |
  15. |---|---|---|---|
  16. | Job Board Scraper | Jobs from LinkedIn, Indeed, Glassdoor, ZipRecruiter, Naukri, Bayt and more in one run | [job-board-scraper](job-board-scraper/) | [datapika.com/actors/job-board-scraper](https://datapika.com/actors/job-board-scraper) |
  17. | Reddit Scraper | Posts, comments, subreddits, users and Reddit Answers | [reddit-scraper](reddit-scraper/) | [datapika.com/actors/reddit-scraper](https://datapika.com/actors/reddit-scraper) |
  18. | TikTok, Douyin & Bilibili Scraper | Videos, profiles, comments, search and trending feeds | [tiktok-douyin-bilibili-scraper](tiktok-douyin-bilibili-scraper/) | [datapika.com/actors/tiktok-douyin-bilibili-scraper](https://datapika.com/actors/tiktok-douyin-bilibili-scraper) |
  19. | Trustpilot Reviews Scraper | Reviews and TrustScore profiles | [trustpilot-reviews-scraper](trustpilot-reviews-scraper/) | [datapika.com/actors/trustpilot-reviews-scraper](https://datapika.com/actors/trustpilot-reviews-scraper) |
  20. | Meta Ad Library Scraper | Facebook and Instagram ads by keyword or page | [meta-ad-library-scraper](meta-ad-library-scraper/) | [datapika.com/actors/meta-ad-library-scraper](https://datapika.com/actors/meta-ad-library-scraper) |
  21. | Google Ads Transparency Scraper | Google ads by advertiser, domain or ID | [google-ads-transparency-scraper](google-ads-transparency-scraper/) | [datapika.com/actors/google-ads-transparency-scraper](https://datapika.com/actors/google-ads-transparency-scraper) |
  22. | Google Maps Scraper | Places with address, phone, website and ratings | [google-maps-scraper](google-maps-scraper/) | [datapika.com/actors/google-maps-scraper](https://datapika.com/actors/google-maps-scraper) |
  23. | Airbnb Scraper | Listings, prices, reviews, calendars and hosts | [airbnb-scraper](airbnb-scraper/) | [datapika.com/actors/airbnb-scraper](https://datapika.com/actors/airbnb-scraper) |
  24. | Google Flights Scraper | Itineraries with prices, stops, segments and CO2 | [google-flights-scraper](google-flights-scraper/) | [datapika.com/actors/google-flights-scraper](https://datapika.com/actors/google-flights-scraper) |
  25. | Hotel & Rental Scraper | Hotel and rental prices from up to 9 booking sites | [hotel-rental-scraper](hotel-rental-scraper/) | [datapika.com/actors/hotel-rental-scraper](https://datapika.com/actors/hotel-rental-scraper) |
  26. The full catalog is at [datapika.com/actors](https://datapika.com/actors).
  27. ## Use it from your AI agent
  28. **Claude Code plugin** (Datapika skill + MCP server in one install):
  29. ```
  30. /plugin install datapika --marketplace lnvestor/datapika-examples
  31. ```
  32. On older Claude Code versions, run `/plugin marketplace add lnvestor/datapika-examples` first, then `/plugin install datapika@datapika`.
  33. **Skill only** (any agent that reads SKILL.md files): copy [`plugins/datapika/skills/datapika/SKILL.md`](plugins/datapika/skills/datapika/SKILL.md) into your agent's skills folder, or run `npx skills add lnvestor/datapika-examples`.
  34. **MCP only**: see [`mcp/`](mcp/) or [datapika.com/mcp](https://datapika.com/mcp) for Claude Code, Cursor, VS Code and Codex configs.
  35. The MCP server is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.lnvestor/datapika) as `io.github.lnvestor/datapika`. Its entry is [`server.json`](server.json), published by [`.github/workflows/mcp-registry.yml`](.github/workflows/mcp-registry.yml).
  36. ## Quick start
  37. 1. Create an Apify account at [console.apify.com/sign-up](https://console.apify.com/sign-up). A free account is enough to start.
  38. 2. Copy your API token from **Settings > API & Integrations** ([console.apify.com/settings/integrations](https://console.apify.com/settings/integrations)) and put it in an environment variable:
  39. ```bash
  40. export APIFY_TOKEN=<your Apify API token>
  41. ```
  42. 3. Clone the repository and install the clients you want to use:
  43. ```bash
  44. git clone https://github.com/lnvestor/datapika-examples.git
  45. cd datapika-examples
  46. python -m pip install -r requirements.txt # Python 3.11 or newer
  47. npm install # Node.js 20 or newer
  48. ```
  49. 4. Run an example from the repository root:
  50. ```bash
  51. ./google-maps-scraper/curl.sh
  52. python google-maps-scraper/python/run.py
  53. node google-maps-scraper/node/run.mjs
  54. ```
  55. The Python and Node.js scripts stream the run log, print one line per result and save every row to `output.json` in the current folder.
  56. ## How the examples call the API
  57. **curl** uses the synchronous endpoint. It starts a run, waits for it to finish and returns the dataset rows in one response:
  58. ```bash
  59. curl -X POST "https://api.apify.com/v2/acts/openclawai~google-maps-scraper/run-sync-get-dataset-items?format=json" \
  60. -H "Authorization: Bearer $APIFY_TOKEN" \
  61. -H "Content-Type: application/json" \
  62. -d '{"query": "coffee shops in Austin, TX", "maxResults": 5}'
  63. ```
  64. The synchronous endpoint waits up to 300 seconds and returns HTTP 408 if the run takes longer. The run keeps going, and its results stay in your Apify account.
  65. **Python and Node.js** start the run and wait for it as long as it takes, then read the rows from the run's default dataset:
  66. ```python
  67. run = client.actor("openclawai/google-maps-scraper").call(run_input=run_input)
  68. items = client.dataset(run.default_dataset_id).list_items().items
  69. ```
  70. ```js
  71. const run = await client.actor('openclawai/google-maps-scraper').call(input);
  72. const { items } = await client.dataset(run.defaultDatasetId).listItems();
  73. ```
  74. Use the client examples for large runs. Each actor README lists every input field the example uses, and the input schema link there shows the rest.
  75. ### Set a spending limit
  76. Actors are priced per result. To cap what one run can cost, pass a maximum total charge in USD:
  77. ```python
  78. from decimal import Decimal
  79. run = client.actor("openclawai/google-maps-scraper").call(
  80. run_input=run_input,
  81. max_total_charge_usd=Decimal("1.00"),
  82. )
  83. ```
  84. ```js
  85. const run = await client.actor('openclawai/google-maps-scraper').call(input, { maxTotalChargeUsd: 1 });
  86. ```
  87. With curl, add `&maxTotalChargeUsd=1` to the URL. The run is not charged more than this amount: it ends when it reaches the limit, and the rows collected so far stay in the dataset.
  88. Prices change, so they are not listed in this repository. Each actor page on [datapika.com/actors](https://datapika.com/actors) shows the current price.
  89. ### Other output formats
  90. The synchronous endpoint and the dataset endpoint both accept `format=json`, `jsonl`, `csv`, `xlsx`, `xml`, `html` or `rss`. To download a finished run's rows as CSV:
  91. ```bash
  92. curl -H "Authorization: Bearer $APIFY_TOKEN" \
  93. "https://api.apify.com/v2/datasets/<datasetId>/items?format=csv" > output.csv
  94. ```
  95. ## Use the actors from an AI agent (MCP)
  96. Every Datapika actor is available as a tool through the Apify MCP server. This config URL, from [datapika.com/llms.txt](https://datapika.com/llms.txt), loads all of them:
  97. ```text
  98. https://mcp.apify.com/?tools=fetch-actor-details,openclawai/job-board-scraper,openclawai/linkedin-jobs-scraper,openclawai/reddit-scraper,openclawai/tiktok-douyin-bilibili-scraper,openclawai/airbnb-scraper,openclawai/career-site-ats-jobs-scraper,openclawai/google-maps-scraper,openclawai/meta-ad-library-scraper,openclawai/google-flights-scraper,openclawai/threads-scraper,openclawai/tiktok-shop-scraper,openclawai/google-ads-transparency-scraper,openclawai/kuaishou-scraper,openclawai/hotel-rental-scraper,openclawai/indeed-ziprecruiter-scraper,openclawai/wechat-scraper,openclawai/youtube-video-scraper,openclawai/trustpilot-reviews-scraper,openclawai/bilibili-scraper
  99. ```
  100. Claude Code:
  101. ```bash
  102. claude mcp add --transport http datapika "https://mcp.apify.com/?tools=fetch-actor-details,openclawai/job-board-scraper,openclawai/linkedin-jobs-scraper,openclawai/reddit-scraper,openclawai/tiktok-douyin-bilibili-scraper,openclawai/airbnb-scraper,openclawai/career-site-ats-jobs-scraper,openclawai/google-maps-scraper,openclawai/meta-ad-library-scraper,openclawai/google-flights-scraper,openclawai/threads-scraper,openclawai/tiktok-shop-scraper,openclawai/google-ads-transparency-scraper,openclawai/kuaishou-scraper,openclawai/hotel-rental-scraper,openclawai/indeed-ziprecruiter-scraper,openclawai/wechat-scraper,openclawai/youtube-video-scraper,openclawai/trustpilot-reviews-scraper,openclawai/bilibili-scraper"
  103. ```
  104. On first use, the client opens Apify sign-in in your browser. The [`mcp/`](mcp/) folder has ready-to-copy configs for Claude Code, Cursor and VS Code, a token-based setup for clients without browser sign-in, and one-tool URLs for each actor.
  105. ## Learn more
  106. - [All actors](https://datapika.com/actors): descriptions, input and output details and current prices
  107. - [Blog](https://datapika.com/blog): original data studies and guides
  108. - [MCP setup](https://datapika.com/mcp) and [REST API overview](https://datapika.com/api)
  109. - [llms.txt](https://datapika.com/llms.txt) and [AGENTS.md](https://datapika.com/AGENTS.md) for agents
  110. - [Apify API reference](https://docs.apify.com/api/v2)
  111. ## Issues
  112. If an example stops working or an input field changes, please [open an issue](https://github.com/lnvestor/datapika-examples/issues) with the actor name and the error you see.
  113. ## License
  114. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.