On-Site Photos is useful when software knows what information or action it needs but the final step requires a person at a physical location. On HumanTask API, the request is framed as a bounded job: send a person to a specific place and capture current visual evidence that cannot be obtained reliably from old listings, street imagery or remote databases. The requester defines the target, timing and proof before anyone accepts the work.
When to Use On-Site Photos
The best on-site photos jobs are concrete enough that two independent workers would understand the same objective. Examples include a storefront has changed and an agent needs current exterior photos; a property team needs the same shot list from several assets; a brand wants to confirm a display is physically present; or a researcher needs present-day images of a location before making a recommendation. These are not broad consulting assignments. They are observable field actions that can be accepted, completed and checked.
Define a On-Site Photos Request
A requester should provide exact address or map pin, required subjects and shot list, and minimum photo count and orientation. It should also state visit window and deadline, access notes and prohibited areas, and required proof such as timestamp or location confirmation. The instruction should separate facts the worker can observe from decisions the AI or business will make later. That distinction prevents a simple field task from quietly turning into specialist advice.
Required inputs
- Exact address or map pin
- Required subjects and shot list
- Minimum photo count and orientation
- Visit window and deadline
- Access notes and prohibited areas
- Required proof such as timestamp or location confirmation
Evidence That Makes the Result Useful
For on-site photos, a useful completion package may contain original image files, structured shot checklist, capture time, location confirmation when available, and worker notes for blocked or missing shots. The evidence schema should be selected before dispatch. A task that merely says “send proof” is weaker than one that specifies which files, fields and observations are mandatory. The receiving agent can then test completeness without interpreting a chat message.
Suggested result fields
- Original image files
- Structured shot checklist
- Capture time
- Location confirmation when available
- Worker notes for blocked or missing shots
Failure Modes to Plan For
Real locations create exceptions that software APIs rarely face. In this capability, common examples are: the location is closed or inaccessible, the requested subject cannot be found, photography is prohibited at the site, and weather or lighting prevents a required shot. Those outcomes should be returned as explicit exception states rather than hidden inside a free-text note. An AI agent can then retry with new instructions, choose another location, widen the deadline or escalate to a specialist.
Exception examples
- The location is closed or inaccessible
- The requested subject cannot be found
- Photography is prohibited at the site
- Weather or lighting prevents a required shot
Example Workflow for an AI Agent
Consider this workflow: An AI agent reviewing a potential retail location can request eight exterior and entrance photos, require a visible street context shot, and continue its analysis after the evidence object is returned. The agent first decides that a physical check is necessary, then creates a on_site_photos task with the address, deadline and evidence fields. The worker accepts the job, completes only the permitted actions and submits the requested proof. After the result arrives, the software can validate required fields, store the media references and continue its original plan.
Who Uses On-Site Photos
On-Site Photos can support real estate, retail, market research, operations, insurance documentation and AI agents that need fresh visual facts. These users have different business goals, but they share the same bottleneck: the missing fact or action exists offline. A reusable task definition lets them solve that bottleneck without maintaining a field team in every city.
API Shape for On-Site Photos
The machine-facing representation should be narrow. A on_site_photos request can carry a normalized location, human-readable instructions, a deadline, budget, required evidence and a client reference. The response should return a task identifier and lifecycle state. Follow-up operations should expose status and evidence without forcing the caller to scrape a dashboard. MCP can present the same operation as an agent tool; REST and OpenAPI can serve conventional application integrations.
Example task object
{
"capability": "on_site_photos",
"location": {"address": "TARGET_ADDRESS"},
"deadline": "ISO_8601",
"instructions": "TASK-SPECIFIC_INSTRUCTIONS",
"evidence_required": ["TASK_SPECIFIC_FIELDS"]
}Launch a On-Site Photos Task
Start with one on-site photos request that has an unambiguous outcome. Define the location, deadline and proof first; then create the task through the web flow or the available developer interface. If the workflow repeats, promote the same evidence schema into a reusable integration.
What makes on-site photos different from a generic gig
The value is not simply that a person is available. The value is that the request is standardized enough for software to understand the expected result. For on-site photos, the schema should reflect the actual decision being supported: the agent needs evidence about send a person to a specific place and capture current visual evidence that cannot be obtained reliably from old listings, street imagery or remote databases. That makes the task easier to price, route, compare and audit than an open-ended message to a freelancer.
{
"task_id": "tsk_example",
"capability": "on_site_photos",
"status": "evidence_submitted",
"evidence": [
{ "type": "photo", "captured_at": "…", "location_confirmed": true }
],
"exceptions": []
}Frequently asked questions
What should a on-site photos request contain?
Include exact address or map pin, required subjects and shot list, minimum photo count and orientation, and visit window and deadline. Add the remaining task-specific fields when they affect access, proof or timing.
What does HumanTask API return for on-site photos?
A result can contain original image files, structured shot checklist, capture time, and location confirmation when available, plus explicit notes when the task cannot be completed as planned.
What can prevent a on-site photos task from completing?
Typical blockers include the location is closed or inaccessible, the requested subject cannot be found, and photography is prohibited at the site. The worker should report the blocker rather than invent a successful result.
Can an AI agent create on-site photos programmatically?
Yes. The intended machine-facing capability is `on_site_photos`, using the same task object whether the caller comes through REST, OpenAPI or MCP.
When is on-site photos a poor fit?
It is a poor fit when the request is unsafe, requires unverified professional expertise, depends on private access that has not been arranged, or cannot be evaluated with observable evidence.
Related pages
- CapabilitiesBrowse real-world tasks that AI agents and businesses can delegate to verified humans worldwide.Explore
- Property VerificationVerify properties with on-site human checks, photos, notes, timestamps and structured evidence.Explore
- Construction Progress PhotosGet verified on-site construction progress photos, timestamps and task-specific evidence.Explore
- Damage DocumentationCapture verified photos, video and structured notes documenting physical damage at a location.Explore
- VerificationHumanTask API verifies real-world task completion with structured evidence such as photos, video, timestamps and location data.Explore
- MCPConnect AI agents to real-world human workers through the HumanTask API MCP server.Explore
- LocationsBrowse HumanTask API coverage by country and city for real-world tasks completed by verified humans.Explore
Next step
Put a human on it.
Describe the place, the action and the proof you need. The API and MCP integration are in developer preview.