---
title: "Create a single-place photos scrape job"
method: POST
path: "/api/v1/photo-jobs"
---

# Create a single-place photos scrape job

`POST /api/v1/photo-jobs`

## Request

- Base URL: `https://gmapsleadfinder.com`
- URL: `https://gmapsleadfinder.com/api/v1/photo-jobs`
- Auth: HTTP bearer

## Request body

- object
  - `place` string, required: Google Maps place URL, share short link (maps.app.goo.gl / goo.gl/maps/…), business_id (0x…:0x…), or Place ID (ChIJ…)

## Response `200`

Photos job queued

- CreateJobResponse
  - `jobId` string, uuid, required
  - `keywordCount` integer, required
  - `creditsRemaining` number, required

## Other responses

- `400`: Invalid place
- `401`: Missing or invalid API key
- `402`: No credits remaining
- `403`: Plan cannot use agent API
- `409`: Another job is already running

---

[API](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api.md) · [All operations](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api/revisions/8482ef74e4bd?raw)