Submit SpiderMapsEnrich Job - SpiderIQ by Di-Atomic

Overview

SpiderMapsEnrich is a second-stage enrichment worker that visits individual Google Maps place pages to extract detailed data not available from the initial SpiderMaps discovery crawl.

Two-Stage Architecture:

SpiderMaps - Discovers businesses via search (returns basic info for 100+ results)
SpiderMapsEnrich - Enriches individual places (returns reviews, photos, analysis)

Best For

Extracting customer reviews and sentiment analysis
Getting negative review breakdown for competitor research
Downloading and hosting business photos
Popular times data extraction
Related places discovery (snowball expansion)
Deep dive on specific businesses from SpiderMaps results

Request Body

payload

object

required

Job configuration payload

Show properties

google_cid

string

Google Maps CID (Customer ID) in hex format.Recommended identifier - More reliable than Place IDs.Format: 0x[hex]:0x[hex]Example: 0x87c9f95545605943:0x6bad649f33559c94Note: One of google_cid, google_place_id, or place_url is required.

google_place_id

string

Google Maps Place ID.Format: ChIJ... (base64-like string)Example: ChIJN1t_tDeuEmsRUsoyG83frY4Note: CIDs are generally more reliable. Use Place ID only when CID is unavailable.

place_url

string

Direct Google Maps place URL.Example: https://www.google.com/maps/place/...Note: URL will be parsed to extract place identifier.

original_data

object

Original SpiderMaps result to merge with enriched data.Useful when chaining SpiderMaps → SpiderMapsEnrich to preserve discovery metadata.

exclude_vps

array

VPS IDs to exclude for IP isolation.Example: ["llm3", "llm4"]Used to avoid rate limiting by ensuring enrichment runs from a different IP than discovery.

use_proxy

boolean

default:"true"

Use mobile proxy for request. Recommended for IP diversity.

enrich_options

object

Enrichment configuration options.

Show enrich_options properties

reviews

object

Review extraction settings.

Show reviews properties

enabled

boolean

default:"true"

Enable review extraction.

max_count

integer

default:"50"

Maximum reviews to extract (1-200).

include_all

boolean

default:"true"

Include all extracted reviews in response.

negative_only

boolean

default:"false"

Only return 1-2 star negative reviews.

photos

object

Photo extraction settings.

Show photos properties

enabled

boolean

default:"true"

Enable photo extraction.

max_count

integer

default:"10"

Maximum photos to extract (1-50).

popular_times

boolean

default:"true"

Extract popular times / busy hours data.

store_images

boolean

default:"true"

Upload photos to SpiderMedia (per-client storage).Returns permanent hosted URLs instead of Google CDN URLs.

snowball

object

Snowball expansion for discovering related places.

Show snowball properties

enabled

boolean

default:"false"

Enable recursive related place discovery.

max_depth

integer

default:"2"

Maximum recursion depth (1-3).

max_places_per_seed

integer

default:"10"

Maximum related places to discover per seed (1-50).

test

boolean

default:"false"

Route to test queue (local workers only).Use for development and testing.

priority

integer

default:"5"

Job priority (0-10, higher = processed first).

Response

job_id

string

Unique job identifier (UUID format).

type

string

Always spiderMapsEnrich.

status

string

Initial status: queued.

created_at

string

Job creation timestamp (ISO 8601).

message

string

Confirmation message.

Example Request

curl -X POST https://spideriq.ai/api/v1/jobs/spiderMapsEnrich/submit \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "google_cid": "0x87c9f95545605943:0x6bad649f33559c94"
    }
  }'

Example Response

201 Created

{
  "job_id": "9c1e51c6-ae76-46d2-958e-b77061ef197d",
  "type": "spiderMapsEnrich",
  "status": "queued",
  "created_at": "2026-01-18T12:31:37.073080",
  "message": "Job submitted successfully"
}

Results Structure

When the job completes, results include:

Core Business Data

data

object

Core business information.

Show data properties

name

string

Business name

address

string

Full address

phone

string

Phone number

website

string

Website URL

rating

number

Google rating (1.0-5.0)

Reviews

reviews

array

Array of extracted reviews.Each review contains:

review_id - Unique review identifier
author - Reviewer name
rating - Star rating (1-5)
text - Review text
date - Review date (relative, e.g., “2 weeks ago”)
is_local_guide - Whether reviewer is a Local Guide
has_owner_response - Whether owner responded
owner_response - Owner’s response (if any)

Review Analysis

review_analysis

object

Automated review sentiment analysis.

Show review_analysis properties

total_extracted

integer

Total reviews extracted.

rating_distribution

object

Breakdown by star rating.

{
  "5_star": 35,
  "4_star": 8,
  "3_star": 4,
  "2_star": 2,
  "1_star": 1
}

negative_reviews

array

Full text of 1-2 star reviews.

negative_count

integer

Count of negative reviews.

negative_percentage

number

Percentage of negative reviews.

owner_response_rate_negative

number

Percentage of negative reviews with owner responses.

common_complaints

array

Detected complaint categories.Categories: service, food_quality, cleanliness, value, wait_time, management

Photos

photos

array

Hosted photo URLs (SpiderMedia).Format: https://media.spideriq.ai/client-{client_id}/gmaps/gmaps_enrich_{cid}_{n}.jpg

photos_original

array

Original Google CDN photo URLs (fallback).

Additional Fields

review_tags

array

Keyword summaries from reviews.Example: ["Great pizza", "Fast service", "Cash only"]

Direct URL to restaurant menu (if available).

street_view_url

string

Constructed Street View URL from coordinates.

popular_times

object

Busy hours data by day of week.

Count of related places discovered (for snowball).

Metadata

metadata

object

Processing metadata.

Show metadata properties

worker_id

string

Worker that processed the job

vps_id

string

VPS identifier

proxy_used

boolean

Whether proxy was used

scrape_time_ms

integer

Processing time in milliseconds

reviews_extracted

integer

Total reviews extracted

reviews_returned

integer

Reviews in response

photos_extracted

integer

Photos found

photos_hosted

integer

Photos uploaded to SpiderMedia

negative_reviews_count

integer

Negative review count

Complete Results Example

{
  "success": true,
  "job_id": "9c1e51c6-ae76-46d2-958e-b77061ef197d",
  "type": "spiderMapsEnrich",
  "status": "completed",
  "processing_time_seconds": 44.13,
  "data": {
    "data": {
      "name": "Joe's Pizza",
      "address": "7 Carmine St, New York, NY 10014",
      "phone": "(212) 366-1182",
      "website": "https://joespizzanyc.com",
      "rating": 4.5,
      "category": "Pizza restaurant"
    },
    "reviews": [
      {
        "review_id": "abc123",
        "author": "John D.",
        "rating": 5,
        "text": "Best pizza in NYC!",
        "date": "2 weeks ago",
        "is_local_guide": true,
        "has_owner_response": false
      }
    ],
    "review_analysis": {
      "total_extracted": 50,
      "rating_distribution": {
        "5_star": 35,
        "4_star": 8,
        "3_star": 4,
        "2_star": 2,
        "1_star": 1
      },
      "negative_reviews": ["Service was slow...", "Overpriced for what you get..."],
      "negative_count": 3,
      "negative_percentage": 6.0,
      "owner_response_rate_negative": 66.7,
      "common_complaints": ["service", "value"]
    },
    "photos": [
      "https://media.spideriq.ai/client-cli_xxx/gmaps/gmaps_enrich_0x123_1.jpg",
      "https://media.spideriq.ai/client-cli_xxx/gmaps/gmaps_enrich_0x123_2.jpg"
    ],
    "review_tags": ["Great pizza", "Fast service", "Cash only"],
    "menu_link": "https://joespizzanyc.com/menu",
    "street_view_url": "https://www.google.com/maps/@40.7305,-73.9996,3a,75y,90t/data=...",
    "popular_times": {},
    "related_places_found": 15,
    "metadata": {
      "worker_id": "spider-maps-enrich-1",
      "vps_id": "llm5",
      "proxy_used": true,
      "scrape_time_ms": 42094,
      "reviews_extracted": 50,
      "reviews_returned": 50,
      "photos_extracted": 5,
      "photos_hosted": 5,
      "negative_reviews_count": 3
    }
  }
}

Complaint Categories

The common_complaints field categorizes negative reviews:

Category	Keywords Detected
`service`	slow service, rude, ignored, unfriendly
`food_quality`	cold food, stale, undercooked, bland
`cleanliness`	dirty, filthy, bugs, smell
`value`	overpriced, expensive, ripoff, small portions
`wait_time`	long wait, slow, took forever
`management`	manager, owner, refused, no refund

Processing Time

Configuration	Typical Time
Basic enrichment (no reviews)	15-30 seconds
With 50 reviews	30-60 seconds
With 200 reviews	60-120 seconds
With proxy	Add 15-30 seconds

Error Cases

Invalid Identifier

{
  "detail": "At least one of google_place_id, google_cid, or place_url is required"
}

Place Not Found

{
  "success": false,
  "status": "failed",
  "error": "Place not found at provided identifier"
}

Next Steps

Check Status

Monitor job progress

Get Results

Retrieve enriched data

SpiderMaps Discovery

Discover places first with SpiderMaps

Deep Enrichment Guide

Complete enrichment workflow

API Reference

​Overview

​Best For

​Request Body

​Response

​Example Request

​Example Response

​Results Structure

​Core Business Data

​Reviews

​Review Analysis

​Photos

​Additional Fields

​Metadata

​Complete Results Example

​Complaint Categories

​Processing Time

​Error Cases

​Invalid Identifier

​Place Not Found

​Next Steps

Check Status

Get Results

SpiderMaps Discovery

Deep Enrichment Guide

Overview

Best For

Request Body

Response

Example Request

Example Response

Results Structure

Core Business Data

Reviews

Review Analysis

Photos

Additional Fields

Metadata

Complete Results Example

Complaint Categories

Processing Time

Error Cases

Invalid Identifier

Place Not Found

Next Steps