{
  "job": "string",
  "data": {
    "api_key": "string",
    "foreign_key": "string",
    "lazy": "boolean",
    "business": {
      "id": "string",
      "name": "string",
      "address": {
        "street": "string",
        "city": "string",
        "state": "string",
        "zip": "string",
        "country": "string"
      },
      "phone": "string",
      "description": "string",
      "tags": ["string"]
    },
    "publishers": {
      "publisher.com": {
        "profile_key": "string",
        "last_review_hashes": ["string"],
        "first_page_only": "boolean",
        "persona": {
          "additional_cookies": {
            "login": [
              {
                "name": "string",
                "value": "string",
                "domain": "string"
              }
            ]
          }
        }
      }
    }
  }
}

Field	Type	Required	Description
job	string	Yes	Must be "AppJobsRequestReviews"
data	object	Yes	Main request data object

Field	Type	Required	Description
api_key	string	Yes	Your API key for authentication
foreign_key	string	Yes	External request identifier
lazy	boolean	Yes	Enable lazy mode for large requests
business	object	Yes	Business information object
publishers	object	Yes	Publisher configurations object
additional_cookies	object	No	Additional cookies for publishers

Job

• Value: Must be exactly "AppJobsRequestReviews"
• Purpose: Identifies the job type for the API
• Validation: Exact string match required

API Key

• Type: string
• Length: Up to 128 characters
• Format: Alphanumeric string
• Purpose: Authentication and authorization
• Example: "ndsjwlb3.Hj70uPbf7dr1............."

Foreign Key

• Type: string
• Length: 1-255 characters
• Purpose: External identifier for tracking requests
• Uniqueness: Should be unique within your system
• Example: "RESTAURANT_001", "HOTEL_2024_001"

Lazy Mode

• Type: boolean
• Purpose: Increases timeout for large requests
• Values:
  • true: Extended timeout, suitable for large datasets
  • false: Standard timeout, suitable for small datasets
• Recommendation: Use true for requests with multiple publishers or large review volumes

Business Object

• Type: object
• Required: Yes
• Description: Complete business information
• Reference: See Business Model for detailed structure

Publishers Object

• Type: object
• Required: Yes
• Description: Key-value pairs where keys are publisher names
• Format: "publisher.com": { publisher_config }
• Reference: See Publisher Model for detailed structure

Additional Cookies

• Type: object
• Required: No
• Description: Additional cookies for specific publishers
• Format: Key-value pairs where keys are publisher names and values are arrays of cookie strings

{
  "job": "App\Jobs\RequestReviews",
  "data": {
    "lazy": true,
    "api_key": "YOUR_API_KEY_HERE",
    "business": {
      "id": "restaurant_001",
      "name": "McDonald's",
      "tags": [
        "restaurant",
        "pizza",
        "italian",
        "casual"
      ],
      "phone": "+12123852066",
      "address": {
        "zip": "10038",
        "city": "New York",
        "state": "NY",
        "street": "160 Broadway",
        "country": "USA"
      },
      "description": "Classic, long-running fast-food chain known for its burgers & fries."
    },
    "publishers": {
      "maps.google.com": {
        "profile_key": "https://www.google.com/maps/place/McDonald's/@40.7094789,-74.0126167,886m/data=!3m2!1e3!5s0x89c2592f4977ef97:0xf78d57398ac93494!4m7!3m6!1s0x89c25a177d4bf5db:0x84e51f23e8c0a75c!8m2!3d40.7094789!4d-74.0100364!10e1!16s%2Fg%2F1thtf190!5m1!1e1?entry=ttu&g_ep=EgoyMDI1MDYyMi4wIKXMDSoASAFQAw%3D%3D",
        "first_page_only": false,
        "last_review_hashes": []
      }
    },
    "foreign_key": "TEST_1751446701622_hznlpc"
  }
}

{
  "error": "Invalid payload",
  "details": {
    "data": {
      "business": {
        "address": {
          "street": ["This field is required."]
        }
      }
    }
  }
}