# ScrapeField

> One API for Google Maps, LinkedIn, Instagram and TikTok. One key, each platform's data in its own documented shape, a published credit cost per endpoint, usage-based billing with no plans or tiers, and failed calls refunded automatically.

Base URL: `https://scrapefield.com/v1`. Auth: `Authorization: Bearer sf_live_…`. Every read is a GET with query parameters.
Responses are `{ "data": …, "meta": { request_id, credits_charged, credits_remaining, cached, fetched_at, next_cursor } }`.
Errors are `{ "error": { type, code, message, docs, request_id } }`. Branch on `code`; it is stable.
Pagination is cursor-only: pass `meta.next_cursor` back as `cursor`.
Each platform's objects are named the way the platform names them: Google Maps after Google's Places API, Instagram after the Graph API, TikTok after TikTok's own APIs, LinkedIn after the words on its pages. Every documented key is always present.
A field is `null` when the platform does not show it — never 0.
Try any endpoint with no key by adding `?demo=true`: it returns realistic sample data in the identical shape, charges nothing, and needs no account.

## Endpoints

### Google Maps

- [GET /v1/google-maps/places](https://scrapefield.com/docs/google-maps/places.md) — Search Google Maps for businesses and places. 3 credits. Requires: query.
- [GET /v1/google-maps/place](https://scrapefield.com/docs/google-maps/place.md) — Get one Google Maps place in full. 3 credits. Requires: one of place_id|url.
- [GET /v1/google-maps/reviews](https://scrapefield.com/docs/google-maps/reviews.md) — Get the reviews for a place. 3 credits. Requires: one of place_id|url.
- [GET /v1/google-maps/photos](https://scrapefield.com/docs/google-maps/photos.md) — Get the photos for a place. 2 credits. Requires: one of place_id|url.

### LinkedIn

- [GET /v1/linkedin/profile](https://scrapefield.com/docs/linkedin/profile.md) — Get a public LinkedIn profile. 10 credits. Requires: one of url|vanity_name.
- [GET /v1/linkedin/company](https://scrapefield.com/docs/linkedin/company.md) — Get a public LinkedIn company page. 6 credits. Requires: one of url|vanity_name.
- [GET /v1/linkedin/posts](https://scrapefield.com/docs/linkedin/posts.md) — Get recent posts from a person or company. 6 credits. Requires: one of profile_url|company_url.
- [GET /v1/linkedin/jobs](https://scrapefield.com/docs/linkedin/jobs.md) — Search public job postings. 4 credits. Requires: query.

### Instagram

- [GET /v1/instagram/profile](https://scrapefield.com/docs/instagram/profile.md) — Get a public Instagram profile. 3 credits. Requires: one of username|url.
- [GET /v1/instagram/posts](https://scrapefield.com/docs/instagram/posts.md) — Get recent posts from a profile. 3 credits. Requires: one of username|url.
- [GET /v1/instagram/post](https://scrapefield.com/docs/instagram/post.md) — Get one post. 2 credits. Requires: one of url|shortcode.
- [GET /v1/instagram/comments](https://scrapefield.com/docs/instagram/comments.md) — Get the comments on a post. 3 credits. Requires: one of url|shortcode.
- [GET /v1/instagram/hashtag](https://scrapefield.com/docs/instagram/hashtag.md) — Get recent posts for a hashtag. 4 credits. Requires: tag.

### TikTok

- [GET /v1/tiktok/profile](https://scrapefield.com/docs/tiktok/profile.md) — Get a public TikTok profile. 3 credits. Requires: one of username|url.
- [GET /v1/tiktok/videos](https://scrapefield.com/docs/tiktok/videos.md) — Get recent videos from a profile. 3 credits. Requires: one of username|url.
- [GET /v1/tiktok/video](https://scrapefield.com/docs/tiktok/video.md) — Get one video. 2 credits. Requires: one of url|id.
- [GET /v1/tiktok/comments](https://scrapefield.com/docs/tiktok/comments.md) — Get the comments on a video. 3 credits. Requires: one of url|id.
- [GET /v1/tiktok/search](https://scrapefield.com/docs/tiktok/search.md) — Search TikTok. 4 credits. Requires: query.

## Also

- [OpenAPI spec](https://scrapefield.com/v1/openapi.json) — complete, with `x-credits` on every operation
- [Full documentation as one file](https://scrapefield.com/llms-full.txt)
- [MCP server](https://scrapefield.com/mcp) — the same endpoints as tools, with a no-key demo mode
- [Agent skill](https://scrapefield.com/skill.md) — when to reach for this API and what the traps are; drop it in as a Claude Skill or a Cursor rule
- [Docs index](https://scrapefield.com/docs.md) — every page on this site is also served as Markdown: add `.md` to any URL
- [Errors](https://scrapefield.com/docs/errors.md) — every code, when it happens and what to do
- [Pricing](https://scrapefield.com/pricing.md) — the credit table
- [Status](https://scrapefield.com/status) — success rate and latency per endpoint, from real traffic