Shopping Seller Offers API

SEO API documentation for REST and MCP, generated from the implemented API contract.

API selector

Search Results (SERP)

API overview

Source-bound Google Shopping seller offers with observed prices and explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved. Owner-only historical results are retained seven days.

Try this API

Endpoint

/api/skill-api/v1/skills/seo-shopping-seller-offers/run

MCP method

nexscope_seo_shopping_seller_offers

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

Missing or invalid API keys return an authentication error. Manage keys from .

POST/api/skill-api/v1/skills/seo-shopping-seller-offers/run

Run an API

Send a JSON request body using the parameters described below.

Slug	`seo-shopping-seller-offers`
Headers	`Authorization: Bearer nk_...` `Content-Type: application/json`
Request body	API-specific JSON object.
Response body	Complete HTTP envelope, including code and data.

Status codes

Code	Description
200	API executed successfully. Body is the direct response payload.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/seo-shopping-seller-offers/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "limit": 10,   "productRef": "0000000000000000000000000000000000000000000000000000000000000000",   "task_id": "00000000-0000-4000-8000-000000000001" }'

All categories/ Search Results (SERP)

POST/api/skill-api/v1/skills/seo-shopping-seller-offers/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Open tester

Endpoint

Method	`POST`
Path	`/api/skill-api/v1/skills/seo-shopping-seller-offers/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request body

Name	Type	Required	Description
`limit`	`integer`	optional	Limit value used by this API operation. Default: 10 Minimum: 1 Maximum: 10
`productRef`	`string`	required	Product ref value used by this API operation. Pattern: ^[0-9a-f]{64}$
`task_id`	`string`	required	DataForSEO task ID returned by the prerequisite Data API call. Format: uuid

Request example

{
  "limit": 10,
  "productRef": "0000000000000000000000000000000000000000000000000000000000000000",
  "task_id": "00000000-0000-4000-8000-000000000001"
}

Response body

Name	Type	Required	Description
`code`	`integer`	required	0 is a successful envelope; inspect data.status separately. Allowed: 0, 42008, 42009
`cost`	`string`	required	Elapsed processing milliseconds; not price. -1 for non-web context.
`data`	`object`	required	Data value used by this API operation.
`data.callId`	`string \| null`	optional	Call id value used by this API operation.
`data.completedAt`	`integer \| null`	optional	Completed at value used by this API operation.
`data.coverage`	`object`	optional	Coverage value used by this API operation.
`data.coverage.missing`	`array`	optional	Missing value used by this API operation.
`data.coverage.missing[]`	`object`	required	Item in data coverage missing.
`data.coverage.missing[].field`	`string`	optional	Field value used by this API operation.
`data.coverage.missing[].reason`	`string`	optional	Reason value used by this API operation.
`data.coverage.status`	`string`	optional	Status value used by this API operation.
`data.requestedAt`	`integer \| null`	optional	Requested at value used by this API operation.
`data.result`	`object \| null`	required	Result value used by this API operation.
`data.result.meta`	`object`	required	Meta value used by this API operation.
`data.result.meta.market`	`object`	required	Market value used by this API operation.
`data.result.meta.market.country`	`string`	required	Country value used by this API operation. Constant: US
`data.result.meta.market.language`	`string`	required	Language value used by this API operation. Constant: en
`data.result.meta.market.locationCode`	`integer`	required	Location code value used by this API operation. Constant: 2840
`data.result.meta.missing`	`array`	required	Missing value used by this API operation. Maximum items: 100
`data.result.meta.missing[]`	`object`	required	Item in data result meta missing.
`data.result.meta.missing[].path`	`string`	required	Path value used by this API operation. Maximum length: 256
`data.result.meta.missing[].reason`	`string`	required	Reason value used by this API operation. Allowed: MISSING, NULL, INVALID, UNSUPPORTED, TRUNCATED
`data.result.meta.missingOverflow`	`boolean`	required	Missing overflow value used by this API operation.
`data.result.meta.retrievedAt`	`any`	required	Retrieved at value used by this API operation.
`data.result.meta.sampledAt`	`any`	required	Sampled at value used by this API operation.
`data.result.meta.source`	`string`	required	Source value used by this API operation. Constant: DATAFORSEO_GOOGLE_SHOPPING_SELLERS
`data.result.meta.truncated`	`boolean`	required	Truncated value used by this API operation.
`data.result.offers`	`array`	required	Offers value used by this API operation. Maximum items: 10
`data.result.offers[]`	`object`	required	Item in data result offers.
`data.result.offers[].basePrice`	`any`	required	Base price value used by this API operation.
`data.result.offers[].currency`	`any`	required	Currency value used by this API operation.
`data.result.offers[].details`	`any`	required	Details value used by this API operation.
`data.result.offers[].domain`	`any`	required	Domain value used by this API operation.
`data.result.offers[].installmentMonths`	`any`	required	Installment months value used by this API operation.
`data.result.offers[].paymentBreakdown`	`any`	required	Payment breakdown value used by this API operation.
`data.result.offers[].rankAbsolute`	`any`	required	Rank absolute value used by this API operation.
`data.result.offers[].rankGroup`	`any`	required	Rank group value used by this API operation.
`data.result.offers[].sellerName`	`any`	required	Seller name value used by this API operation.
`data.result.offers[].shippingPrice`	`any`	required	Shipping price value used by this API operation.
`data.result.offers[].tax`	`any`	required	Tax value used by this API operation.
`data.result.offers[].title`	`any`	required	Title value used by this API operation.
`data.result.offers[].totalPrice`	`any`	required	Total price value used by this API operation.
`data.result.offers[].url`	`any`	required	Url value used by this API operation.
`data.result.productRef`	`string`	required	Product ref value used by this API operation. Pattern: ^[0-9a-f]{64}$
`data.result.sourceCallId`	`string`	required	Source call id value used by this API operation. Format: uuid
`data.schemaVersion`	`string \| null`	optional	Schema version value used by this API operation.
`data.source`	`string \| null`	optional	Source value used by this API operation.
`data.status`	`string`	optional	Status value used by this API operation. Allowed: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED
`data.usage`	`object`	optional	Usage value used by this API operation.
`data.usage.billingStatus`	`string`	optional	Billing status value used by this API operation.
`data.usage.chargedCredits`	`integer \| null`	optional	Charged credits value used by this API operation.
`data.usage.providerCostStatus`	`string`	optional	Provider cost status value used by this API operation.
`data.usage.providerCostUsd`	`string \| null`	optional	Provider cost usd value used by this API operation.
`data.usage.providerRequests`	`integer`	optional	Provider requests value used by this API operation.
`msg`	`string \| null`	required	Msg value used by this API operation.
`time`	`string`	required	yyyy-MM-dd HH:mm:ss
`traceId`	`string \| null`	required	Trace id value used by this API operation.
`ts`	`string`	required	Epoch milliseconds; global long serializer.

Any of option 1

Name	Type	Required	Description
`data.result.meta.retrievedAt`	`integer`	required	Retrieved at value used by this API operation. Minimum: 0 Maximum: 9007199254740991

Any of option 2

Name	Type	Required	Description
`data.result.meta.retrievedAt`	`null`	required	Retrieved at value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.meta.sampledAt`	`integer`	required	Sampled at value used by this API operation. Minimum: 0 Maximum: 9007199254740991

Any of option 2

Name	Type	Required	Description
`data.result.meta.sampledAt`	`null`	required	Sampled at value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].basePrice`	`number`	required	Base price value used by this API operation. Minimum: 0

Any of option 2

Name	Type	Required	Description
`data.result.offers[].basePrice`	`null`	required	Base price value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].currency`	`string`	required	Currency value used by this API operation. Pattern: ^[A-Z]{3}$

Any of option 2

Name	Type	Required	Description
`data.result.offers[].currency`	`null`	required	Currency value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].details`	`string`	required	Details value used by this API operation. Maximum length: 8192

Any of option 2

Name	Type	Required	Description
`data.result.offers[].details`	`null`	required	Details value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].domain`	`string`	required	Domain value used by this API operation. Maximum length: 1024

Any of option 2

Name	Type	Required	Description
`data.result.offers[].domain`	`null`	required	Domain value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].installmentMonths`	`integer`	required	Installment months value used by this API operation. Minimum: 0 Maximum: 9007199254740991

Any of option 2

Name	Type	Required	Description
`data.result.offers[].installmentMonths`	`null`	required	Installment months value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].paymentBreakdown`	`string`	required	Payment breakdown value used by this API operation. Maximum length: 8192

Any of option 2

Name	Type	Required	Description
`data.result.offers[].paymentBreakdown`	`null`	required	Payment breakdown value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].rankAbsolute`	`integer`	required	Rank absolute value used by this API operation. Minimum: 0 Maximum: 9007199254740991

Any of option 2

Name	Type	Required	Description
`data.result.offers[].rankAbsolute`	`null`	required	Rank absolute value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].rankGroup`	`integer`	required	Rank group value used by this API operation. Minimum: 0 Maximum: 9007199254740991

Any of option 2

Name	Type	Required	Description
`data.result.offers[].rankGroup`	`null`	required	Rank group value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].sellerName`	`string`	required	Seller name value used by this API operation. Maximum length: 1024

Any of option 2

Name	Type	Required	Description
`data.result.offers[].sellerName`	`null`	required	Seller name value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].shippingPrice`	`number`	required	Shipping price value used by this API operation. Minimum: 0

Any of option 2

Name	Type	Required	Description
`data.result.offers[].shippingPrice`	`null`	required	Shipping price value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].tax`	`number`	required	Tax value used by this API operation. Minimum: 0

Any of option 2

Name	Type	Required	Description
`data.result.offers[].tax`	`null`	required	Tax value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].title`	`string`	required	Title value used by this API operation. Maximum length: 1024

Any of option 2

Name	Type	Required	Description
`data.result.offers[].title`	`null`	required	Title value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].totalPrice`	`number`	required	Total price value used by this API operation. Minimum: 0

Any of option 2

Name	Type	Required	Description
`data.result.offers[].totalPrice`	`null`	required	Total price value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.result.offers[].url`	`string`	required	Url value used by this API operation. Maximum length: 4096

Any of option 2

Name	Type	Required	Description
`data.result.offers[].url`	`null`	required	Url value used by this API operation.

Response example

Example response envelope from the documented SEO API contract.

{
  "code": 0,
  "cost": "-1",
  "data": {
    "callId": "synthetic-call",
    "completedAt": null,
    "coverage": {
      "missing": [
        {
          "field": "synthetic",
          "reason": "UPSTREAM_FIELD_MISSING"
        }
      ],
      "status": "PARTIAL"
    },
    "requestedAt": 123,
    "result": {
      "meta": {
        "market": {
          "country": "synthetic",
          "language": "synthetic",
          "locationCode": 1
        },
        "missing": [
          {
            "path": "synthetic",
            "reason": "synthetic"
          }
        ],
        "missingOverflow": false,
        "retrievedAt": 9007199254740992,
        "sampledAt": 9007199254740992,
        "source": "synthetic",
        "truncated": false
      },
      "offers": [
        {
          "basePrice": 1.25,
          "currency": "synthetic",
          "details": "synthetic",
          "domain": "synthetic",
          "installmentMonths": 9007199254740992,
          "paymentBreakdown": "synthetic",
          "rankAbsolute": 9007199254740992,
          "rankGroup": 9007199254740992,
          "sellerName": "synthetic",
          "shippingPrice": 1.25,
          "tax": 1.25,
          "title": "synthetic",
          "totalPrice": 1.25,
          "url": "synthetic"
        }
      ],
      "productRef": "synthetic",
      "sourceCallId": "synthetic"
    },
    "schemaVersion": "synthetic",
    "source": "synthetic",
    "status": "PARTIAL",
    "usage": {
      "billingStatus": "UNAPPROVED",
      "chargedCredits": 0,
      "providerCostStatus": "UNAPPROVED",
      "providerCostUsd": null,
      "providerRequests": 0
    }
  },
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "9007199254740993"
}

Responses

Code	Description
200	API executed successfully. Body is the direct response payload.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp

POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_shopping_seller_offers",
    "arguments": {
      "limit": 10,
      "productRef": "0000000000000000000000000000000000000000000000000000000000000000",
      "task_id": "00000000-0000-4000-8000-000000000001"
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

Send a real request with the same contract shown in the reference.

Endpoint

/api/skill-api/v1/skills/seo-shopping-seller-offers/run

Task result endpoint

https://api.nexscope.ai/api/skill-api/v1/skills/seo-shopping-seller-offers/tasks/{taskId}

MCP method

nexscope_seo_shopping_seller_offers

API key*

JSON payload*

cURL

curl -X POST \
  https://api.nexscope.ai/api/skill-api/v1/skills/seo-shopping-seller-offers/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "limit": 10, "productRef": "0000000000000000000000000000000000000000000000000000000000000000", "task_id": "00000000-0000-4000-8000-000000000001" }'

Response

No response yet. Run the request to see the response here.

Task result

Results are checked automatically after Run API. You can also enter a task ID and check it manually; completed resources use Nexscope URLs and show actual charged credits.

Task ID

Result response

No task result yet. Query the task to see the generated output here.