Skip to content
ScrapeField
Get a key

Quickstart

From nothing to a real answer in about two minutes: try it without a key, get one, make a call, read what comes back.

1. Try it without a key

Every endpoint answers demo=true with no key at all. The answer is one fixed answer, the same whatever you ask about, in exactly the shape the real call returns, and it costs nothing. Itsmeta.note says what it is about and what the live call costs. It’s the fastest way to see a response before you write any code.

const params = new URLSearchParams({
  "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "demo": "true"
});

const res = await fetch(`https://api.scrapefield.com/v1/google-maps/place?${params}`);

const { data, meta } = await res.json();
console.log(data, meta.credits_charged);

2. Get a key

  1. 1

    Sign up with your email

    Sign up takes an address and nothing else. We send a link; there is no password.
  2. 2

    Confirm the address

    Open the link and press Confirm and sign in. That signs you in and adds your 2,000 trial credits.
  3. 3

    Create a key

    In the dashboard, under API keys. It’s shown once, so copy it then.

An agent can do this for you: it asks with your email, and you approve it with a code it shows you. From an agent has the two calls.

Keep it in an environment variable rather than in your code:

export SCRAPEFIELD_KEY="sf_live_…"

3. Make a call

The same call, now for real: the key goes in the Authorization header.

const params = new URLSearchParams({
  "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4"
});

const res = await fetch(`https://api.scrapefield.com/v1/google-maps/place?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPEFIELD_KEY}` },
});

const { data, meta } = await res.json();
console.log(data, meta.credits_charged);

4. Read the answer

Every answer has the same two keys. data is the object, or a list of them, in the platform’s own shape. meta says what the call cost, what you have left, whether it came from our cache and how old it is, and the cursor for the next page.

{
  "data": {
    "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "name": "Quill Coffee",
    "category": "Coffee shop",
    "formatted_address": "Avenida Almirante Reis 59, 1100-148 Lisbon, Portugal",
    …
  },
  "meta": {
    "request_id": "req_7f3ac1e94b2d40f8a1c6e5d2",
    "credits_charged": 3,
    "credits_remaining": 1997,
    "cached": false,
    "fetched_at": "2026-09-22T09:12:03Z",
    "next_cursor": null
  }
}

Next