Skip to content
HumanTaskAPI

Capability · store_stock_check

Hire a Human to Check Store Stock

Hire a local human to check product availability, shelf stock, variants and prices in physical stores.

Evidence returnedExample

Store Stock Check · field capture

captured_at · location_confirmed

Structured checklist

required fields · exceptions

Task result object

capability: "store_stock_check"

Store Stock Check 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 into a specific retailer to verify whether a product or variant is physically available at the time of the visit. The requester defines the target, timing and proof before anyone accepts the work.

When to Use Store Stock Check

The best store stock check jobs are concrete enough that two independent workers would understand the same objective. Examples include confirm a SKU is on the shelf; check color, size or model variants; record shelf quantity as an observation; or verify whether an item is behind a counter or display case. These are not broad consulting assignments. They are observable field actions that can be accepted, completed and checked.

Define a Store Stock Check Request

A requester should provide retailer and branch, product name, SKU or reference image, and acceptable substitutes. It should also state variant requirements, visit window, and photo and price requirements. 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

  • Retailer and branch
  • Product name, sku or reference image
  • Acceptable substitutes
  • Variant requirements
  • Visit window
  • Photo and price requirements

Evidence That Makes the Result Useful

For store stock check, a useful completion package may contain available/unavailable status, variant observations, shelf photo where permitted, displayed price, and timestamp and worker notes. 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

  • Available/unavailable status
  • Variant observations
  • Shelf photo where permitted
  • Displayed price
  • Timestamp and worker notes

Failure Modes to Plan For

Real locations create exceptions that software APIs rarely face. In this capability, common examples are: the product is listed online but not found on shelf, stock is present but inaccessible, store staff provide conflicting information, and photography or counting is restricted. 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 product is listed online but not found on shelf
  • Stock is present but inaccessible
  • Store staff provide conflicting information
  • Photography or counting is restricted

Example Workflow for an AI Agent

Consider this workflow: An AI purchasing workflow can confirm that a hard-to-find component is physically present before sending a buyer or arranging collection. The agent first decides that a physical check is necessary, then creates a store_stock_check 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 Store Stock Check

Store Stock Check can support ecommerce teams, brands, procurement, shopping agents and retail intelligence systems. 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 Store Stock Check

The machine-facing representation should be narrow. A store_stock_check 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

json · Example
{
  "capability": "store_stock_check",
  "location": {"address": "TARGET_ADDRESS"},
  "deadline": "ISO_8601",
  "instructions": "TASK-SPECIFIC_INSTRUCTIONS",
  "evidence_required": ["TASK_SPECIFIC_FIELDS"]
}

Launch a Store Stock Check Task

Start with one store stock check 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 store stock check 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 store stock check, the schema should reflect the actual decision being supported: the agent needs evidence about send a person into a specific retailer to verify whether a product or variant is physically available at the time of the visit. That makes the task easier to price, route, compare and audit than an open-ended message to a freelancer.

json · Example result shape
{
  "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 store stock check request contain?

Include retailer and branch, product name, SKU or reference image, acceptable substitutes, and variant requirements. Add the remaining task-specific fields when they affect access, proof or timing.

What does HumanTask API return for store stock check?

A result can contain available/unavailable status, variant observations, shelf photo where permitted, and displayed price, plus explicit notes when the task cannot be completed as planned.

What can prevent a store stock check task from completing?

Typical blockers include the product is listed online but not found on shelf, stock is present but inaccessible, and store staff provide conflicting information. The worker should report the blocker rather than invent a successful result.

Can an AI agent create store stock check programmatically?

Yes. The intended machine-facing capability is `store_stock_check`, using the same task object whether the caller comes through REST, OpenAPI or MCP.

When is store stock check 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.

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.