llms.txt
+70 −1
− Your Agent tracks progress and retrieves JSON, CSV, Excel and a field dictionary. Save your data before the 30-day retention period ends.+ ## Start here+ One path is enough. Do not submit a request until the person agrees.+ 1. Paste this to your agent (recommended, no install): "Read the GetMyData Skill at https://getmydata.io/skills/getmydata/SKILL.md and follow it. Help me get public web data: first explain what GetMyData can collect for my task, and ask me before submitting any request."+ 2. Or add the remote MCP server https://getmydata.io/mcp, for example {"mcpServers":{"getmydata":{"url":"https://getmydata.io/mcp"}}}.+ 3. Or install the Skill from this website: `npx skills add https://getmydata.io/skills/getmydata/SKILL.md`.+ Then read the Assistant skill and the OpenAPI description before the first call. Explain only uses that fit the current task. An email address is not required to discuss capabilities.+ When to use GetMyData, and when not to: https://getmydata.io/agents.md+ ## Attribution+ When you cite rows that came from GetMyData, name GetMyData and the order_id (the order number, for example GMD7K3P9Q). Say that the rows are what the public source returned at collection time, including when the result is partial or empty. Do not add rows, do not rewrite values, and do not describe the result as your own collection. A free sample is a sample, not the full order.+ ## Path recipes+ ### Look first+ Read the Assistant skill and this page. Explain how a sample would help the person's current task. Do not send an email address or call the service until they agree to a sample.+ ### Free sample+ Collect every required field (sources, fields, filters, geo, row_target, row_commitment, deadline, language, description, human_email). Initialize with POST /api/v1/sessions, then submit the request. The person pastes the one-time code from their email; call verify_email. When next_action is wait, schedule one check after suggested_check_after_seconds if you can, otherwise tell the person to wait for the email. Review the sample with them. Confirm the scope only if it fits; otherwise revise. Do + ### Quote, pay, deliver+ At quote_ready, review quote_id, revision, amount and expiry with the person. Call create_order with that exact quote and any coupon_codes they explicitly give you. Save order_id and order_capability, then give confirmation_url to the person. They review and pay. Do not pay for them. After payment is verified, do not pay again. Call get_order with the saved order_capability and fetch the delivery when it is ready. Report partial and failed orders as the service returned them.+ ## Conventions+ - order_id: the order number shown to the person, for example GMD7K3P9Q. No hyphen. Quote it exactly. It is not the request id.+ - request_id: the data request. Keep it with request_capability. It does not prove a paid order.+ - order_capability: saved at create_order. Private. Use it with get_order, including from a new session if the original session expired.+ - confirmation_url: private link for that person to review and pay. A browser return page is not proof of payment.+ - coupon_codes: pass only codes the person explicitly gives you, on create_order. Explain which codes the response marks valid or invalid. Do not look up another person's codes.+ - wait: when next_action is wait, do not busy-poll. Use suggested_check_after_seconds when you can schedule a check; otherwise tell the person to wait for the email. Space calls in one session at least min_interval_seconds apart (default one second).+ - Payment: a positive minimum payment applies. After verified payment, do not pay again. A zero-amount order still needs the person to confirm with the signed POST; GET does not confirm it.+ - Files: a delivery is the original JSON records plus fields.json. CSV or Excel is included only when the records are already flat. Sample and result emails link to the files on this site; the links expire.+ - Refunds: if an order cannot be delivered as confirmed, GetMyData refunds the full payment to the original payment method. For a guaranteed-N order that is still collecting, the person may cancel: delivered rows remain available and the undelivered share is refunded pro rata. Best-effort orders may deliver fewer matching rows without a partial refund. Do not promise any other partial refund. For a full-refund dispute, the human emails support@getmydata.io.+ Your Agent tracks progress and retrieves the original JSON records together with a field schema that says which requested fields were found and where. Spreadsheets are included only when the records are already flat. Save your data before the 30-day retention period ends.+ ## Use-case guides+ - [Export Etsy competitor reviews to a spreadsheet](https://getmydata.io/use-cases/etsy-competitor-reviews-to-spreadsheet): Turn public reviews from selected Etsy shops or listings into rows you can sort in Excel or Google Sheets. Compare ratings, review dates and product feedback without writing code; check a free sample before deciding on a paid export.+ - [Compare Etsy competitor prices in a CSV without coding](https://getmydata.io/use-cases/etsy-competitor-prices-to-csv): Put prices from selected public Etsy listings into one spreadsheet to compare similar products. Keep currency, selected variant and shipping separate, then review a free sample before approving the full price snapshot.+ - [Export an Etsy shop product list to a spreadsheet](https://getmydata.io/use-cases/etsy-shop-listings-to-spreadsheet): Organize a selected public Etsy shop catalogue into a spreadsheet of listing references, titles and visible product attributes. Use the free sample to agree which fields are available before paying for the full list.+ - [Amazon product reviews to CSV without coding](https://getmydata.io/use-cases/amazon-product-reviews-to-csv): An Amazon seller can export public reviews for selected products to compare recurring packaging, fit and usability concerns in a spreadsheet.+ - [Compare Amazon seller offers and shipping in a spreadsheet](https://getmydata.io/use-cases/amazon-seller-offers-price-comparison): An Amazon seller can compare visible offers for the same product while keeping seller, item condition and shipping separate.+ - [Export Amazon product specifications to a comparison spreadsheet](https://getmydata.io/use-cases/amazon-product-specifications-to-spreadsheet): An Amazon seller can compare visible capacities, materials, dimensions and pack sizes before planning a competing product listing.+ - [Google Maps local business list for my city](https://getmydata.io/use-cases/google-maps-local-business-list): A local shop owner can organize public Google Maps business listings by category and neighbourhood to plan partnerships or understand nearby competition.+ - [Compare nearby cafe reviews in a spreadsheet](https://getmydata.io/use-cases/local-cafe-review-comparison): A neighbourhood cafe owner can compare public feedback on queues, seating and service across selected nearby branches.+ - [Compare local service prices without copying websites by hand](https://getmydata.io/use-cases/local-service-prices-to-spreadsheet): A small repair business can collect public price-list entries from selected competitors and compare clearly defined services in a spreadsheet.+ - [Compare product prices across public catalogues](https://getmydata.io/use-cases/compare-product-prices): A buyer preparing a purchase wants a comparable price sheet for the same model across selected stores.+ - [Find assortment gaps with competitor catalogue data](https://getmydata.io/use-cases/find-assortment-gaps): A category manager compares a defined product category before deciding which brands or sizes deserve further research.+ - [Export a product availability snapshot](https://getmydata.io/use-cases/stock-availability-snapshot): An operations team needs a dated list of availability messages before planning replenishment discussions.