Documentation

DataGuru Developer Hub

API Documentation

Welcome to the DataGuru unified API documentation. Browse all guides, explore endpoints, and test parsers directly from this continuous reference.

Getting Started(2 documents)

Getting Started

Quick Start

Start integrating DataGuru in minutes with standard HTTP clients

Start integrating DataGuru in minutes. Our REST APIs allow you to extract structured data from external platforms effortlessly using standard HTTP clients.

Introduction

Start integrating DataGuru in minutes. Our REST APIs allow you to extract structured data from external platforms effortlessly using standard HTTP clients. Each endpoint accepts requests with a standard envelope format and returns structured, typed JSON data.

Base URL & Protocol

Base URL: https://api.dataguru.cc/api/v1 All API requests should use HTTPS. Plain HTTP requests are automatically rejected for security.

1. Obtain Your API Key

Before making requests, you must authenticate. Navigate to the Developer Portal to generate your first API key. Keep this key secure as it grants access to your wallet balance and API requests.

2. Make a Request

Include your API key in the Authorization header using the Api-Key scheme. Most endpoints accept GET requests with query parameters; check each endpoint's own reference page for its exact method and parameters. Here is a basic example calling the Amazon Product Search API:

Product Search Request Example

curl -G "https://api.dataguru.cc/api/v1/amazon/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  --data-urlencode "q=mechanical keyboard"

Getting Started

Authentication

Secure your API requests using API keys

The DataGuru API uses API key authentication via the Api-Key scheme. You must include a valid API key in the headers of all requests to authenticate successfully.

Passing the API Key

Your API key should be passed in the Authorization HTTP header using the Api-Key scheme.

Authorization Header Example

http

Authorization: Api-Key dg_live_9f82b7c4a1e9382d...

Key Environments

DataGuru provides two types of API keys. Use the appropriate key depending on your environment: • **Live Environment Keys (`dg_live_*`)**: Used for production traffic. Live keys deduct the endpoint cost from your deposited USD balance. • **Test Environment Keys (`dg_test_*`)**: Used for testing integration. Returns mock data and does not deduct any funds ($0.00).

Security Best Practice

Never commit your API keys to version control or expose them in client-side code. Use server-side environment variables to keep your keys secure.

Authentication Errors

Connected APIs(63 documents)

Connected APIsPOST

/api/v1/amazon/products/search

Amazon Product Search

POST /api/v1/amazon/products/search

Search for products on Amazon with prices, ratings, and reviews.

Overview

Search for products on Amazon with prices, ratings, and reviews.

POST /api/v1/amazon/products/search

Method: POST Path: /api/v1/amazon/products/search Category: E-Commerce

Guides(4 documents)

Guides

Rate Limits

Concurrency, throughput limits, and retry handling

DataGuru uses rate limiting to prevent abuse and ensure stability for all customers. If your requests exceed your plan's concurrency or throughput limits, the API will respond with a 429 Too Many Requests error.

Rate Limiting Overview

Understanding Headers

Every API response includes headers detailing your current rate limit status. You should use these headers to pace your requests before you hit the limit.

Rate Limit Response Headers

Header	Description
X-RateLimit-Limit	The maximum number of requests you're permitted to make per window.
X-RateLimit-Remaining	The number of requests remaining in the current rate limit window.
X-RateLimit-Reset	The time at which the current rate limit window resets in UTC epoch seconds.

If authentication fails, the API will return one of the following error codes along with a JSON error envelope.

Authentication Error Codes

Status	Code	Description
401	UNAUTHORIZED	No API key was provided or the key format is invalid.
403	FORBIDDEN	The API key exists but is revoked or lacks permissions for this endpoint.
429	RATE_LIMITED	The key has exceeded its rate limit. Retry after the indicated period.

Name	Type	Requirement	Description
product_url	string	Required	Provide the full Amazon Product URL to scrape

Response Schema

Fields returned in a successful response. Nested fields use dot notation and `[]` marks items of a list. Fields that are not required can be missing or `null` when the source does not provide them. Every response also includes a `_metadata` block.

Response Fields

Field	Type	Required	Description
title	string	Yes	Product display title.
main_title	string	Yes	Cleaned main product title.
location	string	Yes	Deliver to location string extracted from page header.
search_filter	string	Yes	Active search department category filter.
product_information	object	Yes	Technical specifications and product details key-value pairs.
parent_asin	string	Yes	Parent ASIN for variant family.
brand	string	Yes	Brand or manufacturer name.
brand_url	string	Yes	URL link to the official brand store on Amazon.
price	string	Yes	Current selling price as formatted string (e.g. '$29.99' or with savings note).
price_symbol	string	Yes	Currency symbol (e.g. '$', '£', '€').
median_price	string	Yes	Median / list basis price string if discounted.
median_price_savings_percentage	string	Yes	Discount percentage string (e.g. '-25%').
is_prime_exclusive	boolean	Yes	True if product has Prime badge or Prime exclusive pricing.
is_frequently_returned	boolean	Yes	True if flagged by Amazon as a frequently returned item.
is_amazon_choice	boolean	Yes	True if item holds the Amazon's Choice badge.
number_of_people_bought	string	Yes	Social proof sales metric (e.g. '10K+ bought in past month').
shipping_info	string	Yes	Primary shipping headline or promise.
delivery	array<string>	Yes	Breakdown of delivery date options and messages.
availability_status	string	Yes	Current stock availability status (e.g. 'In Stock', 'Only 2 left in stock').
unqualified_buy_box	boolean	Yes	True if product lacks standard direct Buy Box (e.g. see all buying options).
aplus	boolean	Yes	True if product page contains A+ Enhanced Brand Content.
previous_price	string	Yes	Strikethrough / reference historical price.
is_coupon_exists	boolean	Yes	True if a clickable clip coupon is available.
main_image	string	Yes	High-resolution primary image URL.
images_of_specified_asin	array<object>	Yes	Detailed image variants data from page script.
images	array<string>	Yes	List of high-resolution product gallery image URLs.
number_of_videos	integer	Yes	Count of product videos uploaded by seller or customers.
media_block	array	Yes	Product video block metadata.
average_rating	string	Yes	Average customer star rating (e.g. '4.6 out of 5 stars').
feature_bullets	array<string>	Yes	About this item bullet points.
total_reviews	string	Yes	Total customer global review count (e.g. '15,234 ratings').
customization_options	object	Yes	Twister variant dimensions (color, size, style, etc.).
merchant_info	object	Yes	Seller and shipping fulfillment identity.
merchant_info.sold_by	string	No
merchant_info.ships_from	string	No
sold_by	string	Yes	Merchant or seller store name.
purchase_options	array	Yes	Purchase formats (One-time purchase, Subscribe & Save).
ratings_distribution	object	Yes	Customer rating breakdown percentages for 1 to 5 stars.
ratings_distribution.5_star	string	No
ratings_distribution.4_star	string	No
ratings_distribution.3_star	string	No
ratings_distribution.2_star	string	No
ratings_distribution.1_star	string	No
customer_reviews	array<object>	Yes	Recent top customer reviews displayed on product page.
customer_reviews[].user_name	string	No
customer_reviews[].rating	string	No
customer_reviews[].review_title	string	No
customer_reviews[].date	string	No
customer_reviews[].review_snippet	string	No

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsGET

/api/v1/quotes/random

Inspiring Quotes

GET /api/v1/quotes/random

Retrieve inspiring random quotes formatted into clean JSON.

Overview

Retrieve inspiring random quotes formatted into clean JSON.

GET /api/v1/quotes/random

Method: GET Path: /api/v1/quotes/random Category: Utility

Request Parameters

Endpoint Parameters

No parameters required for this endpoint.

Request Example

Inspiring Quotes Request Examples

curl -X GET "https://api.dataguru.cc/api/v1/quotes/random" \
  -H "Authorization: Api-Key YOUR_API_KEY"

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "data": [
    {
      "quote": "...",
      "author": "..."
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Inspiring Quotes",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Long-running requests can be processed in the background. Add `?async=true` (or the `Prefer: respond-async` header) to receive a `job_id` immediately, then poll the job until its status is `COMPLETED`.

Async Workflow

curl -X GET "https://api.dataguru.cc/api/v1/quotes/random?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

To run many requests at half price, upload them as a CSV file: one row per request, with the parameter names above as the header row. Rows run in the background within 24 hours (up to 7 days for large files) and each successful row costs 50% of the price below. Poll /api/v1/batches/{batch_id}/ for progress and download results.json when it has finished. See the Batch Processing guide for details.

Batch Workflow

Pricing & Rate Limits

Endpoint Pricing

$0.00 / per request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Standard tier rate limits apply.

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/documents/pdf-parser/jobs

PDF to JSON

POST /api/v1/documents/pdf-parser/jobs

Upload a PDF and get back structured JSON/CSV. Async: submit a job, then poll for the result.

Overview

Upload a PDF and get back structured JSON/CSV. Async: submit a job, then poll for the result.

POST /api/v1/documents/pdf-parser/jobs

Method: POST Path: /api/v1/documents/pdf-parser/jobs Category: Document Processing

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
file	file	Required	The PDF file to extract.
key_fields	string	Optional	Comma-separated list of fields to extract.

Request Example

PDF to JSON Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/documents/pdf-parser/jobs" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -F "file=@/path/to/file.pdf" \
  -F "key_fields=example"

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "PDF to JSON",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/documents/pdf-parser/jobs?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Pricing & Rate Limits

Endpoint Pricing

$0.02 / per request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute20

Per Hour300

Per Day2,000

Monthly Quota20,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Interactive Test Console

Upload a document directly to test this parsing endpoint and view real-time polling results.

Try it live

Connected APIsPOST

/api/v1/documents/resume-parser/jobs

Bulk Resume Parser

POST /api/v1/documents/resume-parser/jobs

Upload a resume and get back structured candidate data (contact info, skills, experience, education). Async: submit a job, then poll for the result.

Overview

Upload a resume and get back structured candidate data (contact info, skills, experience, education). Async: submit a job, then poll for the result.

POST /api/v1/documents/resume-parser/jobs

Method: POST Path: /api/v1/documents/resume-parser/jobs Category: Document Processing

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
file	file	Required	The resume file (PDF) to parse.
job_description	string	Optional	Job description to score the resume against.
job_title	string	Optional	Job title to score the resume against.

Request Example

Bulk Resume Parser Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/documents/resume-parser/jobs" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -F "file=@/path/to/file.pdf" \
  -F "job_description=example" \
  -F "job_title=example"

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Bulk Resume Parser",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/documents/resume-parser/jobs?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Pricing & Rate Limits

Endpoint Pricing

$0.03 / per request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute20

Per Hour300

Per Day2,000

Monthly Quota20,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Interactive Test Console

Upload a document directly to test this parsing endpoint and view real-time polling results.

Try it live

Connected APIsPOST

/api/v1/amazon/keyword-search

Amazon Keyword Search

POST /api/v1/amazon/keyword-search

Search Amazon by keyword and get matching products with titles, prices, ratings and review counts.

Overview

Search Amazon by keyword and get matching products with titles, prices, ratings and review counts.

POST /api/v1/amazon/keyword-search

Method: POST Path: /api/v1/amazon/keyword-search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of products to return (1-50).
location	string	Optional	Two-letter country code to localise results (e.g. US, GB, DE).
query	string	Required	Search keywords, e.g. "wireless mouse".

Request Example

Amazon Keyword Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/amazon/keyword-search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "10", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "total_results_parsed": 0,
  "results": [
    {
      "asin": "string",
      "title": "string",
      "url": "https://example.com/...",
      "image": "https://example.com/...",
      "price": "string",
      "rating": "string",
      "reviews_count": "string"
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Amazon Keyword Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	The search keyword query submitted.
total_results_parsed	integer	Yes	Total number of product items parsed on the current page up to the limit.
results	array<object>	Yes	List of matching product cards from Amazon search results.
results[].asin	string	Yes	Amazon Standard Identification Number (10 characters).
results[].title	string	Yes	Full product listing title.
results[].url	string	Yes	Direct canonical or affiliate URL to the product detail page.
results[].image	string	Yes	Product search thumbnail image URL.
results[].price	string	Yes	Formatted price string (e.g. '$24.99') or empty string if unavailable.
results[].rating	string	Yes	Star rating as string (e.g. '4.5') or empty string.
results[].reviews_count	string	Yes	Number of reviews as formatted string (e.g. '1,420') or '0'.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/amazon/keyword-search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,10,US

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/amazon/bestsellers

Amazon Best Sellers

POST /api/v1/amazon/bestsellers

Get the current Amazon Best Sellers ranking for a category, with rank, title, price and rating.

Overview

Get the current Amazon Best Sellers ranking for a category, with rank, title, price and rating.

POST /api/v1/amazon/bestsellers

Method: POST Path: /api/v1/amazon/bestsellers Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
category	string	Required	Amazon Best Sellers category slug as it appears in the URL, e.g. electronics, books, toys-and-games.
limit	integer	Optional	Maximum number of ranked products to return (1-50).
location	string	Optional	Two-letter country code to localise results (e.g. US, GB, DE).

Request Example

Amazon Best Sellers Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/amazon/bestsellers" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category": "example", "limit": "10", "location": "US"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "bestseller_type": "bestsellers",
  "category_id": "1234567890",
  "category": "string",
  "title": "string",
  "results": [
    {
      "type": "string",
      "rank": 0,
      "title": "string",
      "asin": "string",
      "url": "https://example.com/...",
      "image": "https://example.com/...",
      "stars": 0.0,
      "total_reviews": 0,
      "price": "string",
      "extracted_price": 0.0,
      "position": 0
    }
  ],
  "pagination": {
    "current_page": 0,
    "total_pages": 0
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Amazon Best Sellers",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
bestseller_type	string	Yes	Ranking type identifier (default: 'bestsellers').
category_id	string	Yes	Category slug used in the request (e.g. 'electronics', 'books').
category	string	Yes	Human-readable category department name.
title	string	Yes	Page heading as rendered by Amazon.
results	array<object>	Yes	Ranked products in the Best Sellers category.
results[].type	string	Yes	Listing ranking category type ('bestsellers').
results[].rank	integer \| null	Yes	Amazon sales rank number (e.g. 1, 2, 3).
results[].title	string	Yes	Product display title.
results[].asin	string	Yes	Amazon Standard Identification Number.
results[].url	string	Yes	Direct URL to product listing.
results[].image	string	Yes	Product image URL.
results[].stars	number \| null	Yes	Float rating score out of 5 (e.g. 4.7).
results[].total_reviews	integer	Yes	Integer review count.
results[].price	string	Yes	Price as formatted string (e.g. '$19.99').
results[].extracted_price	number \| null	Yes	Parsed numeric price as float or integer.
results[].position	integer	Yes	Item order position in the parsed page.
pagination	object	Yes	Best Sellers pagination details.
pagination.current_page	integer	Yes	Current active page number.
pagination.total_pages	integer	Yes	Total pages available in category.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/amazon/bestsellers?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

category,limit,location
example,10,US

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/google/search

Google Search

POST /api/v1/google/search

Run a Google web search and get the organic results with titles, links and snippets.

Overview

Run a Google web search and get the organic results with titles, links and snippets.

POST /api/v1/google/search

Method: POST Path: /api/v1/google/search Category: Search Engine

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
country	string	Optional	Country code to localise results, e.g. us, gb, de.
language	string	Optional	Interface language code, e.g. en, de, fr.
num_results	integer	Optional	Number of organic results to return (1-50).
query	string	Required	Search query, e.g. "what is dns".

Request Example

Google Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/google/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "us", "language": "en", "num_results": "10", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "search_information": {
    "time_taken": 0.0,
    "total_results": 0,
    "query_displayed": "string",
    "organic_results_state": "string",
    "original_query_yields_zero_results": false,
    "url": "https://example.com/..."
  },
  "total_time_taken": 0.0,
  "ai_overview": {
    "text_blocks": [
      {
        "type": "heading",
        "snippet": "string",
        "snippet_highlighted_words": [
          "string"
        ],
        "list": [
          {
            "snippet": "string"
          }
        ]
      }
    ],
    "references": [
      {
        "title": "string",
        "link": "https://example.com/...",
        "source": "string"
      }
    ]
  },
  "inline_images": [
    {
      "source": "string",
      "thumbnail": "string",
      "title": "string",
      "link": "https://example.com/..."
    }
  ],
  "inline_videos": [
    {
      "title": "string",
      "source": "string",
      "date": "2026-01-01T12:00:00Z",
      "thumbnail": "string",
      "platform": "string",
      "duration": "string",
      "position": 0
    }
  ],
  "organic_results": [
    {
      "title": "string",
      "link": "https://example.com/...",
      "displayed_link": "https://example.com/...",
      "favicon": "string",
      "source": "string",
      "snippet": "string",
      "highlighted_keywords": [
        "string"
      ],
      "inline_snippet": "string",
      "rank": 0,
      "page_rank": 0,
      "redirect_link": "https://example.com/..."
    }
  ],
  "related_searches": [
    {
      "query": "string",
      "link": "https://example.com/..."
    }
  ],
  "dmca_message": {
    "text": "string",
    "links": [
      "string"
    ]
  },
  "pagination": {
    "current": "string",
    "next": "string",
    "page_no": {}
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Google Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
search_information	object	Yes	Search metadata.
search_information.time_taken	number	Yes	Search time reported by Google, in seconds.
search_information.total_results	integer	Yes	Approximate total result count reported by Google.
search_information.query_displayed	string	Yes	Query that was searched.
search_information.organic_results_state	string	Yes	Spelling state, e.g. 'Results for exact spelling' or Google's 'Showing results for ...' notice.
search_information.original_query_yields_zero_results	boolean	Yes	True if Google reported no results for the query.
search_information.url	string	Yes	Google search URL for the query.
total_time_taken	number	Yes	Total scrape time in seconds.
ai_overview	object	No	Google AI Overview. Present only when Google shows one.
ai_overview.text_blocks	array<object>	Yes	Overview content in order.
ai_overview.text_blocks[].type	string	Yes	Block type.
ai_overview.text_blocks[].snippet	string	No	Text of a heading or paragraph block.
ai_overview.text_blocks[].snippet_highlighted_words	array<string>	No	Bold or emphasised words in a paragraph.
ai_overview.text_blocks[].list	array<object>	No	Items of a list block.
ai_overview.text_blocks[].list[].snippet	string	Yes	Item text.
ai_overview.references	array<object>	No	Sources cited by the overview.
ai_overview.references[].title	string	Yes	Source title.
ai_overview.references[].link	string	Yes	Source URL.
ai_overview.references[].source	string	Yes	Source site name.
inline_images	array<object>	No	Image pack shown in the results. Present only when Google shows one.
inline_images[].source	string	Yes	Site the image comes from.
inline_images[].thumbnail	string	Yes	Thumbnail URL (may be a data: URI).
inline_images[].title	string	Yes	Image title (alt text).
inline_images[].link	string	Yes	Page the image links to.
inline_videos	array<object>	No	Video results shown in the results. Present only when Google shows them.
inline_videos[].title	string	Yes	Video title.
inline_videos[].source	string	Yes	Video platform or publisher (e.g. 'YouTube').
inline_videos[].date	string	Yes	Upload date as shown by Google.
inline_videos[].thumbnail	string	Yes	Thumbnail URL.
inline_videos[].platform	string	Yes	Video platform (same as source).
inline_videos[].duration	string	Yes	Video length as shown by Google (e.g. '10:24').
inline_videos[].position	integer	Yes	Position in the video pack.
organic_results	array<object>	Yes	Organic results, up to num_results, across as many pages as needed.
organic_results[].title	string	Yes	Result title.
organic_results[].link	string	Yes	Destination URL.
organic_results[].displayed_link	string	Yes	URL or breadcrumb shown under the title.
organic_results[].favicon	string	Yes	Site favicon URL. Empty string when unknown.
organic_results[].source	string	Yes	Site name.
organic_results[].snippet	string	Yes	Result description.
organic_results[].highlighted_keywords	array<string>	Yes	Words Google highlighted in the snippet.
organic_results[].inline_snippet	string \| null	Yes	Extra inline text such as a date or rating, when shown.
organic_results[].rank	integer	Yes	Overall position across all pages (1 = first).
organic_results[].page_rank	integer	Yes	Position on its results page.
organic_results[].redirect_link	string	Yes	Raw Google link for the result.
related_searches	array<object>	No	Related searches. Present only when Google shows them.
related_searches[].query	string	Yes	Suggested query.
related_searches[].link	string	Yes	Google search URL for the suggestion.
dmca_message	object	Yes	DMCA removal notice shown by Google, if any.
dmca_message.text	string	Yes	Notice text. Empty string when there is none.
dmca_message.links	array<string>	Yes	Links in the notice.
pagination	object	Yes	Pagination links.
pagination.current	string	Yes	Current page number.
pagination.next	string	Yes	URL of the next results page.
pagination.page_no	object	Yes	Map of page number to page URL (e.g. {"2": "https://www.google.com/search?..."}).

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/google/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,country,language,num_results
example,us,en,10

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/instagram/profile

Instagram Profile

POST /api/v1/instagram/profile

Get a public Instagram profile: name, bio, link, follower and following counts and more.

Overview

Get a public Instagram profile: name, bio, link, follower and following counts and more.

POST /api/v1/instagram/profile

Method: POST Path: /api/v1/instagram/profile Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
profile_url	string	Required	Public profile URL, e.g. https://www.instagram.com/nasa/

Request Example

Instagram Profile Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/instagram/profile" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "username": "string",
  "profile_id": "1234567890",
  "full_name": "string",
  "bio": "string",
  "followers_count": 0,
  "following_count": 0,
  "bio_links": [
    {
      "image_url": "https://example.com/...",
      "is_pinned": false,
      "link_id": "1234567890",
      "link_type": "string",
      "lynx_url": "https://example.com/...",
      "media_accent_color_hex": "string",
      "media_type": "string",
      "title": "string",
      "url": "https://example.com/...",
      "creation_source": "string"
    }
  ],
  "profile_pic_url": "https://example.com/...",
  "profile_pic_url_hd": "https://example.com/...",
  "is_private": false,
  "is_verified": false,
  "is_business_account": false,
  "is_professional_account": false,
  "is_supervision_enabled": false,
  "is_supervised_by_viewer": false,
  "is_supervised_user": false,
  "is_joined_recently": false,
  "business_email": "user@example.com",
  "business_phone_number": "string",
  "business_category_name": "string",
  "overall_category_name": "string",
  "category_enum": "string",
  "category_name": "string",
  "pinned_channels_list_count": 0,
  "highlight_reel_count": 0,
  "video_timeline": {
    "count": 0,
    "videos": [
      {}
    ]
  },
  "related_profiles": [
    {}
  ],
  "owner_to_timeline_media": {
    "count": 0,
    "media": [
      {
        "id": "1234567890",
        "shortcode": "string",
        "type": "string",
        "product_type": "string",
        "url": "https://example.com/...",
        "caption": "string",
        "hashtags": [
          "string"
        ],
        "dimensions": {
          "width": 0,
          "height": 0
        },
        "display_url": "https://example.com/...",
        "images": [
          {}
        ],
        "owner": {
          "id": "1234567890",
          "username": "string"
        },
        "is_video": false,
        "has_audio": false,
        "video_url": "https://example.com/...",
        "comment": "string",
        "likes": 0,
        "preview_likes": 0,
        "video_view_count": 0,
        "thumbnail": "string",
        "timestamp": 0,
        "timestamp_source": "string",
        "taken_at_iso": "string"
      }
    ]
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Instagram Profile",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
username	string	Yes	Instagram username handle without @ symbol.
profile_id	string	Yes	Unique numeric or alphanumeric Instagram user/profile ID.
full_name	string	Yes	Display name of the user or business.
bio	string	Yes	Profile biography text description.
followers_count	integer \| null	Yes	Total number of followers for this profile.
following_count	integer \| null	Yes	Total number of accounts followed by this profile.
bio_links	array<object>	Yes	External links configured in user bio.
bio_links[].image_url	string \| null	Yes	Thumbnail image for the link.
bio_links[].is_pinned	boolean	Yes	True if the link is pinned.
bio_links[].link_id	string	Yes	Instagram link ID. Empty string when unknown.
bio_links[].link_type	string \| null	Yes	Link type, e.g. 'external'.
bio_links[].lynx_url	string \| null	Yes	Instagram redirect (l.instagram.com) URL for the link.
bio_links[].media_accent_color_hex	string \| null	Yes	Accent colour of the link thumbnail.
bio_links[].media_type	string \| null	Yes	Thumbnail media type, e.g. 'none'.
bio_links[].title	string	Yes	Link title or label.
bio_links[].url	string	Yes	External destination URL.
bio_links[].creation_source	string	Yes	Source where link was created, e.g. NONE or BIO.
profile_pic_url	string \| null	Yes	Standard resolution profile picture URL.
profile_pic_url_hd	string \| null	Yes	High definition profile picture URL.
is_private	boolean	Yes	Whether the profile account is set to private.
is_verified	boolean	Yes	Whether the profile has a blue verified badge.
is_business_account	boolean \| null	Yes	Whether the account is classified as a business account.
is_professional_account	boolean \| null	Yes	Whether the account is classified as a professional/creator account.
is_supervision_enabled	boolean \| null	Yes	Whether parental/guardian supervision is enabled on the account.
is_supervised_by_viewer	boolean \| null	Yes	Whether the viewing account supervises this account.
is_supervised_user	boolean \| null	Yes	Whether this profile user is under supervision.
is_joined_recently	boolean \| null	Yes	Whether the account was created recently.
business_email	string \| null	Yes	Public business contact email address if available.
business_phone_number	string \| null	Yes	Public business phone number if available.
business_category_name	string \| null	Yes	Primary business category title.
overall_category_name	string \| null	Yes	Overall category classification name.
category_enum	string \| null	Yes	Internal category enumeration key.
category_name	string \| null	Yes	Category name displayed on the profile.
pinned_channels_list_count	integer \| null	Yes	Count of pinned broadcast channels.
highlight_reel_count	integer \| null	Yes	Total number of story highlight reels.
video_timeline	object	Yes	Video timeline metadata.
video_timeline.count	integer \| null	Yes	Total count of video items.
video_timeline.videos	array<object>	Yes	List of video items from video timeline.
related_profiles	array<object>	Yes	List of related recommended profile suggestions.
owner_to_timeline_media	object	Yes	Recent post media items from the user's timeline.
owner_to_timeline_media.count	integer \| null	Yes	Total number of posts on the user's timeline.
owner_to_timeline_media.media	array<object>	Yes	Array of timeline media posts.
owner_to_timeline_media.media[].id	string	Yes	Media ID.
owner_to_timeline_media.media[].shortcode	string	Yes	Instagram shortcode identifier.
owner_to_timeline_media.media[].type	string	Yes	Media type (e.g. 'Image', 'Video', 'Carousel').
owner_to_timeline_media.media[].product_type	string	Yes	Product classification (e.g. 'feed', 'clips', 'carousel_container').
owner_to_timeline_media.media[].url	string	Yes	Full post URL link.
owner_to_timeline_media.media[].caption	string	Yes	Post caption text.
owner_to_timeline_media.media[].hashtags	array<string>	Yes	Extracted hashtags from the caption.
owner_to_timeline_media.media[].dimensions	object	Yes	Width and height dimensions.
owner_to_timeline_media.media[].dimensions.width	integer \| null	No
owner_to_timeline_media.media[].dimensions.height	integer \| null	No
owner_to_timeline_media.media[].display_url	string	Yes	Direct image or poster display URL.
owner_to_timeline_media.media[].images	array<object>	Yes	Image resolutions or carousel items.
owner_to_timeline_media.media[].owner	object	Yes
owner_to_timeline_media.media[].owner.id	string	Yes	Owner profile ID.
owner_to_timeline_media.media[].owner.username	string	Yes	Owner username.
owner_to_timeline_media.media[].is_video	boolean	Yes	True if media contains video.
owner_to_timeline_media.media[].has_audio	boolean \| null	No	True if media contains audio.
owner_to_timeline_media.media[].video_url	string \| null	No	Direct video stream URL if video.
owner_to_timeline_media.media[].comment	string \| object \| null	No	Featured comment or comment block.
owner_to_timeline_media.media[].likes	integer \| null	No	Likes count.
owner_to_timeline_media.media[].preview_likes	integer \| null	No	Preview likes count.
owner_to_timeline_media.media[].video_view_count	integer \| null	No	Play or view count for video.
owner_to_timeline_media.media[].thumbnail	string	Yes	Thumbnail preview URL.
owner_to_timeline_media.media[].timestamp	integer \| null	No	Unix timestamp when media was taken.
owner_to_timeline_media.media[].timestamp_source	string \| null	No	Source of timestamp calculation.
owner_to_timeline_media.media[].taken_at_iso	string \| null	No	ISO-8601 formatted datetime string.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/instagram/profile?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

profile_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0008 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/instagram/post

Instagram Post

POST /api/v1/instagram/post

Get the details of a public Instagram post or reel: caption, hashtags, tagged users, media and engagement.

Overview

Get the details of a public Instagram post or reel: caption, hashtags, tagged users, media and engagement.

POST /api/v1/instagram/post

Method: POST Path: /api/v1/instagram/post Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
post_url	string	Required	Public post or reel URL, e.g. https://www.instagram.com/p/SHORTCODE/

Request Example

Instagram Post Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/instagram/post" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "post": {
    "url": "https://example.com/...",
    "shortcode": "string",
    "image": "string",
    "title": "string",
    "caption": "string",
    "description": "string",
    "mediaId": "1234567890",
    "taken_at": 0,
    "taken_at_iso": "string",
    "like_count": 0,
    "comment_count": 0
  },
  "account": {
    "username": "string",
    "userId": "1234567890",
    "profileUrl": "https://example.com/...",
    "profilePic": "string"
  },
  "comments": [
    {
      "id": "1234567890",
      "text": "string",
      "created_at": 0,
      "created_at_iso": "string",
      "like_count": 0,
      "parent_comment_id": "1234567890",
      "user": {
        "id": "1234567890",
        "username": "string",
        "full_name": "string",
        "profile_pic_url": "https://example.com/...",
        "is_verified": false
      }
    }
  ],
  "comments_page_info": {
    "end_cursor": "string",
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "string"
  },
  "relatedPosts": [
    {
      "shortcode": "string",
      "mediaId": "1234567890",
      "media_type": 0,
      "url": "https://example.com/...",
      "thumbnail_url": "https://example.com/...",
      "caption": "string",
      "like_count": 0,
      "comment_count": 0,
      "view_count": 0,
      "taken_at": 0,
      "taken_at_iso": "string",
      "owner": {
        "id": "1234567890",
        "username": "string",
        "is_verified": false,
        "profile_pic_url": "https://example.com/..."
      }
    }
  ],
  "alternateUrls": [
    {
      "lang": "string",
      "url": "https://example.com/..."
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Instagram Post",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
post	object	Yes	Post details including metrics, timestamps, and media content.
post.url	string	Yes	Canonical post or reel URL.
post.shortcode	string	Yes	Instagram shortcode identifier.
post.image	string \| null	Yes	Main post image or video poster URL.
post.title	string \| null	Yes	Extracted post title if available.
post.caption	string \| null	Yes	Full post caption text.
post.description	string \| null	Yes	Meta description content from post header.
post.mediaId	string	Yes	Numeric or alphanumeric Instagram media ID.
post.taken_at	integer \| null	Yes	Unix timestamp when post was published.
post.taken_at_iso	string \| null	Yes	ISO-8601 UTC formatted publication timestamp.
post.like_count	integer \| null	Yes	Total number of likes.
post.comment_count	integer \| null	Yes	Total number of comments.
account	object	Yes	Author account information for the post.
account.username	string	Yes	Author username handle.
account.userId	string	Yes	Author numeric user ID.
account.profileUrl	string	Yes	Link to the author's Instagram profile.
account.profilePic	string	Yes	Author profile picture image URL.
comments	array<object>	Yes	List of top/initial comments extracted from the post.
comments[].id	string	Yes	Unique comment identifier.
comments[].text	string	Yes	Comment text content.
comments[].created_at	integer \| null	Yes	Unix timestamp of comment creation.
comments[].created_at_iso	string \| null	Yes	ISO-8601 UTC formatted comment creation timestamp.
comments[].like_count	integer	Yes	Number of likes on the comment.
comments[].parent_comment_id	string \| null	Yes	Parent comment ID if this comment is a reply.
comments[].user	object	Yes
comments[].user.id	string \| null	Yes	Commenter user ID.
comments[].user.username	string \| null	Yes	Commenter username handle.
comments[].user.full_name	string \| null	Yes	Commenter full name.
comments[].user.profile_pic_url	string \| null	Yes	Commenter profile avatar URL.
comments[].user.is_verified	boolean	Yes	Whether commenter has a verified badge.
comments_page_info	object	Yes	Pagination metadata for comments.
comments_page_info.end_cursor	string \| null	Yes	Cursor pointing to the end of the current comment page.
comments_page_info.has_next_page	boolean	Yes	True if more comments exist after this page.
comments_page_info.has_previous_page	boolean	Yes	True if earlier comments exist before this page.
comments_page_info.start_cursor	string \| null	Yes	Cursor pointing to the start of the current comment page.
relatedPosts	array<object>	Yes	Related posts or child carousel cards associated with this post.
relatedPosts[].shortcode	string	Yes	Shortcode identifier.
relatedPosts[].mediaId	string	Yes	Unique media ID.
relatedPosts[].media_type	integer	Yes	Media type number (e.g. 1 for image, 2 for video/reel, 8 for carousel).
relatedPosts[].url	string	Yes	Post URL link.
relatedPosts[].thumbnail_url	string	Yes	Thumbnail image URL.
relatedPosts[].caption	string \| null	Yes	Caption text if present.
relatedPosts[].like_count	integer \| null	Yes	Likes count.
relatedPosts[].comment_count	integer \| null	Yes	Comment count.
relatedPosts[].view_count	integer \| null	Yes	Video view count if video.
relatedPosts[].taken_at	integer \| null	Yes	Unix publication timestamp.
relatedPosts[].taken_at_iso	string \| null	Yes	ISO-8601 formatted datetime string.
relatedPosts[].owner	object	Yes
relatedPosts[].owner.id	string \| null	Yes	Owner ID.
relatedPosts[].owner.username	string \| null	Yes	Owner username handle.
relatedPosts[].owner.is_verified	boolean	Yes	Owner verified status.
relatedPosts[].owner.profile_pic_url	string \| null	Yes	Owner profile picture URL.
alternateUrls	array<object>	Yes	List of alternate language / canonical URLs discovered on the page.
alternateUrls[].lang	string	Yes	Language code from the page's hreflang (e.g. 'en', 'x-default').
alternateUrls[].url	string	Yes	Post URL for that language.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/instagram/post?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

post_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0008 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/instagram/comments

Instagram Comments

POST /api/v1/instagram/comments

Get the public comments on an Instagram post or reel.

Overview

Get the public comments on an Instagram post or reel.

POST /api/v1/instagram/comments

Method: POST Path: /api/v1/instagram/comments Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
max_comments	integer	Optional	Maximum number of comments to return (1-500).
post_url	string	Required	Public post or reel URL, e.g. https://www.instagram.com/p/SHORTCODE/

Request Example

Instagram Comments Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/instagram/comments" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_comments": "50", "post_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "post": {
    "url": "https://example.com/...",
    "shortcode": "string",
    "caption": "string",
    "mediaId": "1234567890",
    "like_count": 0,
    "comment_count": 0,
    "media_type": 0,
    "taken_at": 0,
    "taken_at_iso": "string"
  },
  "account": {
    "username": "string",
    "userId": "1234567890",
    "profileUrl": "https://example.com/...",
    "profilePic": "string",
    "is_verified": false
  },
  "comments": [
    {
      "id": "1234567890",
      "text": "string",
      "created_at": 0,
      "created_at_iso": "string",
      "like_count": 0,
      "reply_count": 0,
      "parent_comment_id": "1234567890",
      "user": {
        "id": "1234567890",
        "username": "string",
        "full_name": "string",
        "profile_pic_url": "https://example.com/...",
        "is_verified": false
      }
    }
  ],
  "comments_count": 0,
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Instagram Comments",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
post	object	Yes	Information about the parent post or reel being commented on.
post.url	string	Yes	Full canonical post URL.
post.shortcode	string	Yes	Instagram shortcode identifier.
post.caption	string \| null	Yes	Post caption text.
post.mediaId	string	Yes	Instagram media ID.
post.like_count	integer \| null	Yes	Post like count.
post.comment_count	integer \| null	Yes	Total number of comments on the post.
post.media_type	integer	Yes	Media type (1 for photo, 2 for video/reel).
post.taken_at	integer \| null	Yes	Unix timestamp of post publication.
post.taken_at_iso	string \| null	Yes	ISO-8601 formatted publication timestamp.
account	object	Yes	Author of the parent post.
account.username	string	Yes	Author username handle.
account.userId	string	Yes	Author user ID.
account.profileUrl	string	Yes	Author profile URL link.
account.profilePic	string	Yes	Author profile avatar picture URL.
account.is_verified	boolean	Yes	Whether the author account is verified.
comments	array<object>	Yes	List of parsed comments up to the requested max_comments limit.
comments[].id	string	Yes	Unique comment identifier.
comments[].text	string	Yes	Comment content text.
comments[].created_at	integer \| null	Yes	Unix timestamp of comment creation.
comments[].created_at_iso	string \| null	Yes	ISO-8601 UTC formatted comment creation timestamp.
comments[].like_count	integer	Yes	Number of likes on this comment.
comments[].reply_count	integer \| null	Yes	Count of nested comment replies.
comments[].parent_comment_id	string \| null	Yes	Parent comment ID if this comment is a reply, or null if top-level.
comments[].user	object	Yes
comments[].user.id	string \| null	Yes	Commenter numeric user ID.
comments[].user.username	string \| null	Yes	Commenter username handle.
comments[].user.full_name	string \| null	Yes	Commenter display name.
comments[].user.profile_pic_url	string \| null	Yes	Commenter profile avatar picture URL.
comments[].user.is_verified	boolean	Yes	Whether commenter has a verified badge.
comments_count	integer	Yes	Total number of comments extracted in this response.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/instagram/comments?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

post_url,max_comments
example,50

Pricing & Rate Limits

Endpoint Pricing

$0.001 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsGET

/api/v1/california/attorneys

California Attorneys

GET /api/v1/california/attorneys

Search licensed attorneys of the State Bar of California by bar number, name, location, practice area or law school. Returns license status, admission date, contact details, practice areas, languages, certified specialties and disciplinary history.

Overview

GET /api/v1/california/attorneys

Method: GET Path: /api/v1/california/attorneys Category: Legal

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
bar_number	string	Optional	State Bar number, e.g. 115321.
city	string	Optional	City of the registered address, e.g. Los Angeles.
first_name	string	Optional	First name or its beginning.
last_name	string	Optional	Last name or its beginning, e.g. Smi.
law_school	string	Optional	Part of the law school name, e.g. Stanford.
page	integer	Optional	Page number (default 1).
page_size	integer	Optional	Results per page, 1-100 (default 20).
practice_area	string	Optional	Exact practice area as listed by the State Bar, e.g. Immigration.
q	string	Optional	Free-text search across name, firm, city, practice areas, law school and bar number.
state	string	Optional	Two-letter state of the registered address, e.g. CA.
zip	string	Optional	ZIP code or its beginning, e.g. 900.

Request Example

California Attorneys Request Examples

curl -X GET "https://api.dataguru.cc/api/v1/california/attorneys?bar_number=example&city=example&first_name=example&last_name=example&law_school=example&page=1&page_size=1&practice_area=example&q=example&state=example&zip=example" \
  -H "Authorization: Api-Key YOUR_API_KEY"

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "California Attorneys",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X GET "https://api.dataguru.cc/api/v1/california/attorneys?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

bar_number,city,first_name,last_name,law_school,page,page_size,practice_area,q,state,zip
example,example,example,example,example,1,1,example,example,example,example

Pricing & Rate Limits

Endpoint Pricing

$0.001 / per record (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/tiktok/profile

TikTok Profile

POST /api/v1/tiktok/profile

Get a public TikTok profile: username, name, bio, follower and following counts, likes, verification, stats and profile photo.

Overview

Get a public TikTok profile: username, name, bio, follower and following counts, likes, verification, stats and profile photo.

POST /api/v1/tiktok/profile

Method: POST Path: /api/v1/tiktok/profile Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
profile_url	string	Required	Public TikTok profile URL or username, e.g. https://www.tiktok.com/@tiktok

Request Example

TikTok Profile Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/profile" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "id": "1234567890",
  "short_id": "1234567890",
  "username": "string",
  "nickname": "string",
  "profile_url": "https://example.com/...",
  "bio": "string",
  "security_user_id": "1234567890",
  "avatar": "string",
  "verified": false,
  "private_account": false,
  "is_secret": false,
  "is_commerce_account": false,
  "commerce_category": "string",
  "is_seller": false,
  "is_organization": false,
  "is_ad_virtual": false,
  "is_embed_banned": false,
  "ftc": false,
  "bio_link": "https://example.com/...",
  "region": "string",
  "language": "string",
  "created_at": 0,
  "created_at_iso": "string",
  "username_last_changed_at": 0,
  "nickname_last_changed_at": 0,
  "followers": 0,
  "following": 0,
  "likes": 0,
  "video_count": 0,
  "digg_count": 0,
  "friend_count": 0,
  "duet_setting": 0,
  "stitch_setting": 0,
  "comment_setting": 0,
  "download_setting": 0,
  "following_visibility": 0,
  "open_favorite": false,
  "relation": 0,
  "profile_tabs": {
    "music": false,
    "questions": false,
    "playlists": false,
    "can_expand_playlist": false
  },
  "is_live": false,
  "room_id": "1234567890",
  "recommend_reason": "string",
  "canonical_url": "https://example.com/...",
  "share_title": "string",
  "share_description": "string",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "TikTok Profile",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
id	string	Yes	Unique numeric or string TikTok user identifier.
short_id	string \| null	No	Short numeric ID if assigned.
username	string	Yes	TikTok username handle without leading @ symbol.
nickname	string	Yes	Profile display nickname.
profile_url	string	Yes	Standard TikTok profile URL.
bio	string	Yes	User profile bio signature text.
security_user_id	string	Yes	Encrypted secure user ID (secUid).
avatar	string	Yes	High resolution profile avatar image URL.
verified	boolean	Yes	True if account has verified blue checkmark.
private_account	boolean	Yes	True if profile account is set to private.
is_secret	boolean	Yes	True if account is marked as secret.
is_commerce_account	boolean	Yes	True if registered as a TikTok commerce / business account.
commerce_category	string \| null	Yes	Business or commerce category classification.
is_seller	boolean	Yes	True if account is registered as a TikTok Shop seller.
is_organization	boolean	Yes	True if account represents an organization.
is_ad_virtual	boolean	Yes	True if virtual advertiser account.
is_embed_banned	boolean	Yes	True if video embedding is disallowed.
ftc	boolean	Yes	Under-age / FTC compliance privacy flag.
bio_link	string \| null	Yes	External website URL linked in user profile bio.
region	string \| null	Yes	Country / region code of account origin.
language	string	Yes	Primary user language code (e.g. 'en').
created_at	integer \| null	Yes	Account registration timestamp in Unix seconds.
created_at_iso	string \| null	Yes	Account creation timestamp in UTC ISO-8601 format.
username_last_changed_at	integer \| null	Yes	Unix timestamp when username handle was last modified.
nickname_last_changed_at	integer \| null	Yes	Unix timestamp when display nickname was last modified.
followers	integer	Yes	Total count of followers.
following	integer	Yes	Total count of accounts followed.
likes	integer	Yes	Total number of hearts / likes received across all videos.
video_count	integer	Yes	Total number of public videos posted.
digg_count	integer	Yes	Number of videos liked by this user.
friend_count	integer	Yes	Number of mutual friends.
duet_setting	integer	Yes	Privacy setting permission code for duets.
stitch_setting	integer	Yes	Privacy setting permission code for stitches.
comment_setting	integer	Yes	Privacy setting permission code for comments.
download_setting	integer	Yes	Privacy setting permission code for video downloads.
following_visibility	integer	Yes	Visibility setting code for following list.
open_favorite	boolean	Yes	True if favorites collection is publicly visible.
relation	integer	Yes	Follow relationship status code with current viewer.
profile_tabs	object	Yes	Visibility flags for profile tabs (music, questions, playlists).
profile_tabs.music	boolean	Yes
profile_tabs.questions	boolean	Yes
profile_tabs.playlists	boolean	Yes
profile_tabs.can_expand_playlist	boolean	Yes
is_live	boolean	Yes	True if the creator is currently broadcasting a live stream.
room_id	string \| null	Yes	Live stream broadcast room ID if live.
recommend_reason	string \| null	Yes	Recommendation reason string if suggested profile.
canonical_url	string	Yes	Canonical profile link.
share_title	string	Yes	Meta share title for social preview.
share_description	string	Yes	Meta share description text.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/profile?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

profile_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0009 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/tiktok/post

TikTok Post

POST /api/v1/tiktok/post

Get details of a public TikTok post/video: caption, creator, video download links, music, views, likes, shares and bookmarks.

Overview

Get details of a public TikTok post/video: caption, creator, video download links, music, views, likes, shares and bookmarks.

POST /api/v1/tiktok/post

Method: POST Path: /api/v1/tiktok/post Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
post_url	string	Required	Public TikTok post or video URL, e.g. https://www.tiktok.com/@tiktok/video/7299103344556677

Request Example

TikTok Post Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/post" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "id": "1234567890",
  "canonical_url": "https://example.com/...",
  "description": "string",
  "created_at": "2026-01-01T12:00:00Z",
  "created_at_unix": 0,
  "schedule_time": 0,
  "location_created": "string",
  "index_enabled": false,
  "text_language": "string",
  "is_advertisement": false,
  "is_ai_generated_content": false,
  "ai_generated_content_description": "string",
  "secret": false,
  "private_item": false,
  "for_friend": false,
  "original_item": false,
  "official_item": false,
  "take_down": 0,
  "digged": false,
  "collected": false,
  "duet_enabled": false,
  "stitch_enabled": false,
  "item_comment_status": 0,
  "backend_type": "string",
  "content_desc": "string",
  "is_content_classified": false,
  "content_classification_reason": "string",
  "stats": {
    "likes": 0,
    "comments": 0,
    "shares": 0,
    "plays": 0,
    "bookmarks": 0,
    "reposts": 0
  },
  "author": {
    "id": "1234567890",
    "username": "string",
    "nickname": "string",
    "signature": "string",
    "avatar": "string",
    "verified": false,
    "secret": false,
    "private_account": false,
    "open_favorite": false,
    "comment_setting": 0,
    "duet_setting": 0,
    "stitch_setting": 0,
    "room_id": "1234567890",
    "unique_id_modify_time": 0,
    "nickname_modify_time": 0,
    "created_at": "2026-01-01T12:00:00Z",
    "created_at_unix": 0,
    "stats": {
      "followers": 0,
      "following": 0,
      "likes": 0,
      "videos": 0,
      "digg_count": 0,
      "friends": 0
    }
  },
  "videos_and_audio": {
    "video_id": "1234567890",
    "video_url": "https://example.com/...",
    "music_id": "1234567890",
    "music_title": "string",
    "music_author": "string",
    "music_url": "https://example.com/...",
    "duration": 0,
    "cover_image_url": "https://example.com/...",
    "dynamic_cover_url": "https://example.com/...",
    "download_url": "https://example.com/...",
    "play_url": "https://example.com/..."
  },
  "video": {
    "id": "1234567890",
    "height": 0,
    "width": 0,
    "duration": 0,
    "ratio": "string",
    "cover": "string",
    "origin_cover": "string",
    "dynamic_cover": "string",
    "play_url": "https://example.com/...",
    "download_url": "https://example.com/...",
    "format": "string",
    "bitrate": 0,
    "codec_type": "string",
    "definition": "string",
    "volume_info": {
      "loudness": 0.0,
      "peak": 0.0
    }
  },
  "music": {
    "id": "1234567890",
    "title": "string",
    "author": "string",
    "album": "string",
    "duration": 0,
    "cover": "string",
    "play_url": "https://example.com/...",
    "original": false,
    "precise_duration": {
      "precise_duration": 0.0,
      "precise_shoot_duration": 0.0,
      "precise_audition_duration": 0.0,
      "precise_video_duration": 0.0
    }
  },
  "repost": {
    "can_repost": false
  },
  "hashtags": [
    {
      "id": "1234567890",
      "title": "string",
      "url": "https://example.com/..."
    }
  ],
  "mentions": [
    {
      "id": "1234567890",
      "username": "string",
      "security_user_id": "1234567890"
    }
  ],
  "stickers_on_item": [
    {
      "stickerText": [
        "string"
      ],
      "stickerType": 0
    }
  ],
  "effect_stickers": [
    "string"
  ],
  "anchors": [
    "string"
  ],
  "warn_info": [
    "string"
  ],
  "app_context": {
    "language": "string",
    "region": "string",
    "request_id": "1234567890",
    "cluster_region": "string"
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "TikTok Post",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
id	string	Yes	Unique numeric TikTok video ID.
canonical_url	string	Yes	Canonical TikTok video URL.
description	string	Yes	Post caption / title text.
created_at	string	Yes	Publication timestamp in UTC ISO-8601 format.
created_at_unix	integer	Yes	Publication timestamp in Unix seconds.
schedule_time	integer \| null	No	Scheduled post timestamp if applicable.
location_created	string	No	Country / region code where video was created.
index_enabled	boolean	No	True if search engine indexing is allowed.
text_language	string	No	Detected language code of video caption.
is_advertisement	boolean	No	True if marked as sponsored or advertisement.
is_ai_generated_content	boolean	No	True if creator or system flagged content as AI-generated.
ai_generated_content_description	string \| null	No	Details regarding AI generation disclosure.
secret	boolean	No	True if post is private or secret.
private_item	boolean	No	True if item is private.
for_friend	boolean	No	True if post is shared with friends only.
original_item	boolean	No	True if post is original content.
official_item	boolean	No	True if official item.
take_down	integer	No	Takedown status code.
digged	boolean	No	True if viewer liked this post.
collected	boolean	No	True if viewer bookmarked / favorited this post.
duet_enabled	boolean	No	True if duets are permitted.
stitch_enabled	boolean	No	True if stitches are permitted.
item_comment_status	integer	No	Comment permission status code.
backend_type	string \| integer \| null	No	Internal backend classification type.
content_desc	string	No	Content description or transcript summary.
is_content_classified	boolean	No	True if content is age-restricted or sensitive.
content_classification_reason	string \| null	No	Reason for content restriction if classified.
stats	object	Yes	Post engagement metrics and play counts.
stats.likes	integer	Yes	Total like / digg count.
stats.comments	integer	Yes	Total comment count.
stats.shares	integer	Yes	Total share count.
stats.plays	integer	Yes	Total video view count.
stats.bookmarks	integer	Yes	Total bookmarks / favorites count.
stats.reposts	integer	Yes	Total reposts count.
author	object	Yes	Creator account metadata.
author.id	string	Yes	Creator user ID.
author.username	string	Yes	Creator username handle.
author.nickname	string	Yes	Creator display nickname.
author.signature	string	No	Creator bio signature.
author.avatar	string	Yes	Creator avatar image URL.
author.verified	boolean	Yes	Whether creator is verified.
author.secret	boolean	No	True if the author's account is secret.
author.private_account	boolean	No	True if the author's account is private.
author.open_favorite	boolean	No	True if the author's favourites are public.
author.comment_setting	integer	No	Who can comment on the author's posts (TikTok setting code).
author.duet_setting	integer	No	Who can duet the author's posts (TikTok setting code).
author.stitch_setting	integer	No	Who can stitch the author's posts (TikTok setting code).
author.room_id	string \| null	No	Live room ID when the author is live, otherwise null.
author.unique_id_modify_time	integer	No	Unix time the username was last changed (0 when never or unknown).
author.nickname_modify_time	integer	No	Unix time the display name was last changed (0 when never or unknown).
author.created_at	string \| null	No	Account creation time in UTC ISO-8601.
author.created_at_unix	integer	No	Account creation time in Unix seconds (0 when unknown).
author.stats	object	Yes
author.stats.followers	integer	No
author.stats.following	integer	No
author.stats.likes	integer	No
author.stats.videos	integer	No
author.stats.digg_count	integer	No
author.stats.friends	integer	No
videos_and_audio	object	Yes	Consolidated audio and video media download/streaming URLs.
videos_and_audio.video_id	string	Yes
videos_and_audio.video_url	string	Yes
videos_and_audio.music_id	string	Yes
videos_and_audio.music_title	string	Yes
videos_and_audio.music_author	string	Yes
videos_and_audio.music_url	string	No
videos_and_audio.duration	integer	Yes
videos_and_audio.cover_image_url	string	Yes
videos_and_audio.dynamic_cover_url	string	No
videos_and_audio.download_url	string	Yes
videos_and_audio.play_url	string	Yes
video	object	Yes	Technical video stream specifications and dimensional data.
video.id	string	Yes
video.height	integer	Yes
video.width	integer	Yes
video.duration	integer	Yes
video.ratio	string	No
video.cover	string	No
video.origin_cover	string	No
video.dynamic_cover	string	No
video.play_url	string	Yes
video.download_url	string	Yes
video.format	string	No
video.bitrate	integer	No
video.codec_type	string	No
video.definition	string	No
video.volume_info	object	No
video.volume_info.loudness	number \| null	No	Integrated loudness of the audio track (LUFS).
video.volume_info.peak	number \| null	No	Peak audio level.
music	object	Yes	Background music track details and audio streams.
music.id	string	Yes
music.title	string	Yes
music.author	string	Yes
music.album	string	No
music.duration	integer	Yes
music.cover	string	No
music.play_url	string	Yes
music.original	boolean	No
music.precise_duration	object	No
music.precise_duration.precise_duration	number \| null	No	Exact sound duration in seconds.
music.precise_duration.precise_shoot_duration	number \| null	No	Sound duration used when recording, in seconds.
music.precise_duration.precise_audition_duration	number \| null	No	Preview duration in seconds.
music.precise_duration.precise_video_duration	number \| null	No	Duration of the video using the sound, in seconds.
repost	object	No
repost.can_repost	boolean	No
hashtags	array<object>	Yes	Hashtags referenced in video caption.
hashtags[].id	string	No
hashtags[].title	string	Yes
hashtags[].url	string	Yes
mentions	array<object>	Yes	Tagged user mentions in video caption.
mentions[].id	string	No
mentions[].username	string	No
mentions[].security_user_id	string	No
stickers_on_item	array<object>	No	Text stickers shown on the video.
stickers_on_item[].stickerText	array<string>	No	Text of the sticker.
stickers_on_item[].stickerType	integer	No	TikTok sticker type code.
effect_stickers	array	No
anchors	array	No
warn_info	array	No
app_context	object	No
app_context.language	string	No	Page language.
app_context.region	string	No	Region TikTok served the page for.
app_context.request_id	string	No	TikTok request ID. Empty string when unknown.
app_context.cluster_region	string	No	TikTok server cluster region.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/post?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

post_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0009 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/walmart/products/details

Walmart Product Details

POST /api/v1/walmart/products/details

Scrape Walmart product details, pricing, stock, local store pickup, aisle location, and seller info.

Overview

Scrape Walmart product details, pricing, stock, local store pickup, aisle location, and seller info.

POST /api/v1/walmart/products/details

Method: POST Path: /api/v1/walmart/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code to localise results (e.g. US).
product_url	string	Required	Provide the full Walmart Product URL to scrape.
zip_code	string	Optional	US ZIP code to check local pickup availability and aisle location (e.g. 75001).

Request Example

Walmart Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/walmart/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example", "zip_code": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "search_information": {
    "location": {
      "postal_code": "string",
      "province_code": "string",
      "city": "string"
    }
  },
  "product_results": {
    "us_item_id": "1234567890",
    "product_id": "1234567890",
    "variants": [
      "string"
    ],
    "upc": "string",
    "title": "string",
    "short_description": "string",
    "description": "string",
    "seller_id": "1234567890",
    "seller_name": "string",
    "has_seller_badge": false,
    "brand": "string",
    "standard_delivery_date": "2026-01-01T12:00:00Z",
    "fulfillment_type": "string",
    "in_stock": false,
    "out_of_stock": false,
    "price": 0.0,
    "currency": "USD",
    "was_price": 0.0,
    "fulfillment_badge": "string",
    "fulfillment_title": "string",
    "images": [
      "https://example.com/..."
    ],
    "specifications": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "variant_categories": [
      "string"
    ],
    "selections": [
      "string"
    ]
  },
  "reviews_results": {
    "ratings": [
      {
        "stars": 0,
        "count": 0,
        "percentage": 0.0
      }
    ],
    "reviews": {
      "rating": 0.0,
      "count": 0,
      "recommended_percentage": 0,
      "top_positive": {},
      "top_negative": {},
      "top_mentions": [
        "string"
      ],
      "customer_reviews": [
        "string"
      ]
    }
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Walmart Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
search_information	object	Yes	Location and postal context used for price and availability.
search_information.location	object	No
search_information.location.postal_code	string \| null	No
search_information.location.province_code	string \| null	No
search_information.location.city	string \| null	No
product_results	object	Yes	Comprehensive product information extracted from Walmart.
product_results.us_item_id	string	Yes	Walmart US Item ID.
product_results.product_id	string	Yes	Walmart base Product ID.
product_results.variants	array<string>	Yes	List of variant attributes for current selection.
product_results.upc	string	Yes	Universal Product Code.
product_results.title	string	Yes	Product title.
product_results.short_description	string	Yes	Short summary text.
product_results.description	string	Yes	Full HTML/text product description.
product_results.seller_id	string	Yes	Identifier for the seller.
product_results.seller_name	string	Yes	Seller store name (e.g. 'Walmart.com').
product_results.has_seller_badge	boolean	Yes	True if seller has verified badge.
product_results.brand	string	Yes	Product brand name.
product_results.standard_delivery_date	string	Yes	Estimated delivery arrival date.
product_results.fulfillment_type	string	Yes	Type of fulfillment (e.g. 'FC_DELIVERY', 'STORE_DELIVERY').
product_results.in_stock	boolean	Yes	True if item is available for purchase.
product_results.out_of_stock	boolean	Yes	True if item is out of stock.
product_results.price	number \| null	Yes	Current selling price as float.
product_results.currency	string	Yes	ISO currency code (e.g. 'USD', 'CAD').
product_results.was_price	number \| null	Yes	Previous / strikethrough price.
product_results.fulfillment_badge	string	Yes	Fulfillment badge code.
product_results.fulfillment_title	string	Yes	Fulfillment heading or promise.
product_results.images	array<string>	Yes	High-resolution image URLs.
product_results.specifications	array<object>	Yes
product_results.specifications[].name	string	Yes
product_results.specifications[].value	string	Yes
product_results.variant_categories	array	Yes	Available variant grouping dimensions.
product_results.selections	array	Yes	Selected variant combinations and child product IDs.
reviews_results	object	Yes	Ratings and customer reviews summary.
reviews_results.ratings	array<object>	Yes
reviews_results.ratings[].stars	integer	No
reviews_results.ratings[].count	integer	No
reviews_results.ratings[].percentage	number	No
reviews_results.reviews	object	Yes
reviews_results.reviews.rating	number \| null	Yes
reviews_results.reviews.count	integer	Yes
reviews_results.reviews.recommended_percentage	integer	Yes
reviews_results.reviews.top_positive	object	Yes
reviews_results.reviews.top_negative	object	Yes
reviews_results.reviews.top_mentions	array	Yes
reviews_results.reviews.customer_reviews	array	Yes

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/walmart/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location,zip_code
example,US,example

Pricing & Rate Limits

Endpoint Pricing

$0.0018 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/walmart/search

Walmart Search

POST /api/v1/walmart/search

Search Walmart by keyword or search URL and get matching products, seller details, ratings and reviews.

Overview

Search Walmart by keyword or search URL and get matching products, seller details, ratings and reviews.

POST /api/v1/walmart/search

Method: POST Path: /api/v1/walmart/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code to localise results (e.g. US).
page	integer	Optional	Page number of search results.
query	string	Required	Search keyword or full Walmart search URL (e.g. "air fryer" or "https://www.walmart.com/search?q=air+fryer").

Request Example

Walmart Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/walmart/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "page": "1", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "search_results": [
    {
      "title": "string",
      "description": "string",
      "totalItemCount": 0,
      "item": [
        {
          "title": "string",
          "id": "1234567890",
          "usItemId": "1234567890",
          "type": "string",
          "thumbnail": "https://example.com/...",
          "brand": "string",
          "canonicalUrl": "https://example.com/...",
          "returnPolicy": {},
          "rating": {
            "averageRating": 0.0,
            "numberOfReviews": 0
          },
          "fulfillment": {
            "isEligibleForPickup": false,
            "isEligibleForDelivery": false
          },
          "priceInfo": {
            "linePrice": "string",
            "itemPrice": "string",
            "unitPrice": "string"
          },
          "orderLimit": 0,
          "isSponsoredFlag": false,
          "shippingOption": "string"
        }
      ]
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Walmart Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
search_results	array<object>	Yes	Search result groupings and items returned for the query.
search_results[].title	string	Yes	Search stack heading (e.g. 'Results for "air fryer"').
search_results[].description	string \| null	Yes	Optional search stack description.
search_results[].totalItemCount	integer	Yes	Total number of items found for this query.
search_results[].item	array<object>	Yes	List of product cards in this search stack.
search_results[].item[].title	string	Yes	Product display title.
search_results[].item[].id	string	Yes	Walmart product ID.
search_results[].item[].usItemId	string	Yes	Walmart US Item ID.
search_results[].item[].type	string	Yes	Listing type (e.g. 'REGULAR').
search_results[].item[].thumbnail	string	Yes	Thumbnail image URL.
search_results[].item[].brand	string \| null	Yes	Brand name.
search_results[].item[].canonicalUrl	string	Yes	Canonical product URL on Walmart.
search_results[].item[].returnPolicy	object	Yes	Return policy terms.
search_results[].item[].rating	object	Yes
search_results[].item[].rating.averageRating	number \| null	No
search_results[].item[].rating.numberOfReviews	integer \| null	No
search_results[].item[].fulfillment	object	Yes
search_results[].item[].fulfillment.isEligibleForPickup	boolean	No
search_results[].item[].fulfillment.isEligibleForDelivery	boolean	No
search_results[].item[].priceInfo	object	Yes
search_results[].item[].priceInfo.linePrice	string	Yes
search_results[].item[].priceInfo.itemPrice	string	Yes
search_results[].item[].priceInfo.unitPrice	string	Yes
search_results[].item[].orderLimit	integer \| null	Yes	Maximum purchase limit per customer.
search_results[].item[].isSponsoredFlag	boolean	Yes	True if listing is sponsored.
search_results[].item[].shippingOption	string \| null	Yes	Shipping guarantee or arrival text.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/walmart/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,location,page
example,US,1

Pricing & Rate Limits

Endpoint Pricing

$0.0018 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/reddit/post

Reddit Post

POST /api/v1/reddit/post

Scrape Reddit posts, subreddits, user profiles and listing pages with metrics, flairs, and metadata.

Overview

Scrape Reddit posts, subreddits, user profiles and listing pages with metrics, flairs, and metadata.

POST /api/v1/reddit/post

Method: POST Path: /api/v1/reddit/post Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of posts to return for listing/feed pages.
url	string	Required	Reddit post, subreddit, or user profile URL / path (e.g. https://www.reddit.com/r/webdev/comments/1xaevy8/...)

Request Example

Reddit Post Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/reddit/post" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "10", "url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "posts_and_subreddits": {
    "post_id": "1234567890",
    "title": "string",
    "self_text_markdown": "string",
    "subreddit_name": "string",
    "author_username": "string",
    "upvote_score": 0,
    "upvote_ratio_pct": 0,
    "total_comments": 0,
    "url_link_domain": "https://example.com/...",
    "crosspost_count": 0,
    "post_flair": "string",
    "spoiler": false,
    "nsfw": false,
    "pinned_stickied": false,
    "post_type": "string",
    "created_timestamp": "2026-01-01T12:00:00Z",
    "post_url": "https://example.com/...",
    "content_url": "https://example.com/...",
    "subreddit_id": "1234567890",
    "author_id": "1234567890"
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Reddit Post",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
posts_and_subreddits	object \| array<object>	Yes	Extracted Reddit post data for a single post or list of posts from a subreddit or user feed.
posts_and_subreddits.post_id	string	Yes	Reddit post ID without the 't3_' prefix (e.g. '1xaevy8').
posts_and_subreddits.title	string	Yes	Post submission headline title.
posts_and_subreddits.self_text_markdown	string	Yes	Body text content of the post formatted as markdown.
posts_and_subreddits.subreddit_name	string	Yes	Prefixed subreddit name (e.g. 'r/webdev').
posts_and_subreddits.author_username	string	Yes	Prefixed username of author (e.g. 'u/username' or '[deleted]').
posts_and_subreddits.upvote_score	integer	Yes	Net upvotes / score for the post.
posts_and_subreddits.upvote_ratio_pct	integer \| null	No	Upvote ratio percentage (0 to 100), or null if not available.
posts_and_subreddits.total_comments	integer	Yes	Total number of comments submitted on the post.
posts_and_subreddits.url_link_domain	string	Yes	Domain of outbound link or 'self.subreddit' for text posts.
posts_and_subreddits.crosspost_count	integer \| null	No	Number of times the post was crossposted.
posts_and_subreddits.post_flair	string	Yes	Post flair text label.
posts_and_subreddits.spoiler	boolean	Yes	Whether the post is marked as a spoiler.
posts_and_subreddits.nsfw	boolean	Yes	Whether the post is marked as NSFW (Not Safe For Work).
posts_and_subreddits.pinned_stickied	boolean	Yes	Whether the post is stickied / pinned to the subreddit or profile.
posts_and_subreddits.post_type	string	Yes	Post type classification (e.g. 'text', 'link', 'image', 'video').
posts_and_subreddits.created_timestamp	string	Yes	Creation timestamp in ISO-8601 string or numeric string format.
posts_and_subreddits.post_url	string	Yes	Full permanent canonical Reddit URL to the post.
posts_and_subreddits.content_url	string	Yes	Outbound link URL or media content URL.
posts_and_subreddits.subreddit_id	string	No	Reddit internal subreddit identifier (e.g. 't5_...').
posts_and_subreddits.author_id	string	No	Reddit internal author identifier (e.g. 't2_...').

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/reddit/post?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

url,limit
example,10

Pricing & Rate Limits

Endpoint Pricing

$0.001 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/reddit/comments

Reddit Comments

POST /api/v1/reddit/comments

Scrape complete nested comment trees and replies from a Reddit post or discussion thread.

Overview

Scrape complete nested comment trees and replies from a Reddit post or discussion thread.

POST /api/v1/reddit/comments

Method: POST Path: /api/v1/reddit/comments Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of root comment threads to extract.
url	string	Required	Reddit post URL (e.g. https://www.reddit.com/r/webdev/comments/1xaevy8/...)

Request Example

Reddit Comments Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/reddit/comments" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "10", "url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "comment_trees": {
    "post_id": "1234567890",
    "comments": [
      {
        "author": "string",
        "markdown_content": "string",
        "upvotes": 0,
        "distinguished_status": "string",
        "awards": [
          "string"
        ],
        "replies": []
      }
    ]
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Reddit Comments",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
comment_trees	object	Yes	Extracted comment tree structure for the Reddit post.
comment_trees.post_id	string	Yes	Reddit post ID without prefix.
comment_trees.comments	array<object>	Yes	Top-level comment threads with nested replies.
comment_trees.comments[].author	string	Yes	Prefixed username of comment author (e.g. 'u/username' or '[deleted]').
comment_trees.comments[].markdown_content	string	Yes	Comment body text formatted as markdown.
comment_trees.comments[].upvotes	integer	Yes	Score / upvote count for this comment.
comment_trees.comments[].distinguished_status	string \| null	No	Distinguished badge type if posted by a moderator or admin.
comment_trees.comments[].awards	array<string>	No	List of award names received by this comment.
comment_trees.comments[].replies	array<object>	Yes	Nested child comment replies. (same structure as its parent, nested recursively)

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/reddit/comments?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

url,limit
example,10

Pricing & Rate Limits

Endpoint Pricing

$0.001 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/ebay/products/details

eBay Product Details

POST /api/v1/ebay/products/details

Scrape eBay product details, price, condition, seller feedback, specifications, shipping, and return policies.

Overview

Scrape eBay product details, price, condition, seller feedback, specifications, shipping, and return policies.

POST /api/v1/ebay/products/details

Method: POST Path: /api/v1/ebay/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code to localise results (e.g. US).
product_url	string	Required	Full eBay Product URL or Item ID (e.g. 168130314813 or https://www.ebay.com/itm/168130314813).

Request Example

eBay Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/ebay/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "product_results": {
    "title": "string",
    "itemId": "1234567890",
    "product_category": [
      {
        "name": "string",
        "link": "https://example.com/..."
      }
    ],
    "seller": {
      "name": "string",
      "reviews": "string",
      "positive_feedback_percent": "string",
      "thumbnail": "https://example.com/..."
    },
    "likes": 0,
    "price": "string",
    "extracted_price": 0.0,
    "listing_lifecycle": "string",
    "condition": "string",
    "condition_snippet": "string",
    "is_buy_it_now": false,
    "buy_it_now_link": "https://example.com/...",
    "availability": "string",
    "main_image": "https://example.com/...",
    "images": [
      "https://example.com/..."
    ],
    "shipping_details": [
      {
        "shipping_service": "string",
        "shipping_cost": "string",
        "estimated_delivery": "string"
      }
    ],
    "return_details": {
      "returns_accepted": false,
      "return_period": "string",
      "return_shipping_paid_by": "string"
    },
    "payment_methods": [
      "string"
    ],
    "extensions": [
      "string"
    ],
    "specifications": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "upc": "string",
    "item_description_from_seller": "string",
    "product": {
      "product_id": "1234567890",
      "rating": 0.0,
      "feature_rating": {},
      "reviews": 0,
      "reviews_histogram": {}
    },
    "about_seller": {
      "name": "string",
      "bio": "string",
      "positive_feedback_percent": 0.0,
      "items_sold": 0,
      "joined": "string",
      "link": "https://example.com/...",
      "contact": "string",
      "feature_rating": {},
      "popular_categories": [
        {
          "name": "string",
          "link": "https://example.com/..."
        }
      ],
      "reviews": {
        "all_products": {
          "total": 0,
          "reviews": [
            "string"
          ]
        }
      }
    },
    "sections": [
      "string"
    ],
    "sold_out": false
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "eBay Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
product_results	object	Yes	Detailed product information extracted from the eBay item page.
product_results.title	string	Yes	Full title of the product listing.
product_results.itemId	string	Yes	Unique eBay numeric item ID.
product_results.product_category	array<object>	Yes	Hierarchical breadcrumb categories leading to this item.
product_results.product_category[].name	string	Yes	Category name.
product_results.product_category[].link	string	Yes	Direct URL to category browse page.
product_results.seller	object	Yes	Summary of seller identity, review count, and positive rating.
product_results.seller.name	string	Yes	Username / store name of the seller.
product_results.seller.reviews	string	Yes	Total count of reviews or feedback score as string.
product_results.seller.positive_feedback_percent	string	Yes	Percentage positive feedback rating string (e.g. '99.9%').
product_results.seller.thumbnail	string	Yes	URL to seller avatar or logo thumbnail.
product_results.likes	integer \| null	Yes	Number of watchers or saves for this item.
product_results.price	string	Yes	Display price string (e.g. 'US $39.99' or '$539.00').
product_results.extracted_price	number \| null	Yes	Parsed numeric price as float or integer.
product_results.listing_lifecycle	string	Yes	Status of the listing (e.g. 'active', 'ended').
product_results.condition	string	Yes	Declared item condition (e.g. 'New with box', 'Pre-Owned', 'Good - Refurbished').
product_results.condition_snippet	string	Yes	Seller remarks or notes regarding condition.
product_results.is_buy_it_now	boolean	Yes	Indicates whether the item can be purchased immediately via Buy It Now.
product_results.buy_it_now_link	string	Yes	Direct checkout or Buy It Now link.
product_results.availability	string	Yes	Stock status text (e.g. '4 available / 5 sold', 'Last one', 'In Stock').
product_results.main_image	string	Yes	Primary high-resolution product image URL.
product_results.images	array<string>	Yes	List of high-resolution product gallery image URLs.
product_results.shipping_details	array<object>	Yes	Available delivery methods, shipping costs, and estimated arrival dates.
product_results.shipping_details[].shipping_service	string	No	Carrier or shipping service name.
product_results.shipping_details[].shipping_cost	string	No	Cost of shipping (e.g. 'Free', '$4.99').
product_results.shipping_details[].estimated_delivery	string	No	Estimated delivery timeframe.
product_results.return_details	object	Yes	Return policy details specified by the seller.
product_results.return_details.returns_accepted	boolean	No	True if seller accepts returns.
product_results.return_details.return_period	string	No	Return window period (e.g. '30 days').
product_results.return_details.return_shipping_paid_by	string	No	Party responsible for return shipping cost (e.g. 'Buyer', 'Seller').
product_results.payment_methods	array<string>	Yes	Accepted payment options (e.g. PayPal, Visa, Mastercard, Apple Pay, Google Pay).
product_results.extensions	array<string>	Yes	Additional promotional highlights and badges.
product_results.specifications	array<object>	Yes	Item specific key-value pairs (brand, model, size, color, MPN, etc.).
product_results.specifications[].name	string	Yes	Specification attribute name.
product_results.specifications[].value	string	Yes	Specification attribute value.
product_results.upc	string	Yes	Universal Product Code (UPC) if available.
product_results.item_description_from_seller	string	Yes	URL to the seller's full HTML item description iframe or content.
product_results.product	object	Yes	Rating and aggregate reviews metrics for this product.
product_results.product.product_id	string	Yes	Product identifier.
product_results.product.rating	number	Yes	Aggregate star rating (e.g. 5.0).
product_results.product.feature_rating	object	Yes	Feature-level rating percentages.
product_results.product.reviews	integer	Yes	Total review count.
product_results.product.reviews_histogram	object	Yes	Distribution of 1-5 star reviews.
product_results.about_seller	object	Yes	Comprehensive seller background, ratings, and store statistics.
product_results.about_seller.name	string	Yes	Seller display name.
product_results.about_seller.bio	string	Yes	Seller bio description.
product_results.about_seller.positive_feedback_percent	number	Yes	Numeric positive feedback percentage (e.g. 99.9).
product_results.about_seller.items_sold	integer	Yes	Estimated total number of items sold by seller.
product_results.about_seller.joined	string	Yes	Year or date seller registered on eBay.
product_results.about_seller.link	string	Yes	Direct link to the seller's store or profile.
product_results.about_seller.contact	string	Yes	Seller contact link.
product_results.about_seller.feature_rating	object	Yes	Detailed ratings breakdown for accuracy, communication, shipping speed, etc.
product_results.about_seller.popular_categories	array<object>	Yes	Store categories featured by seller.
product_results.about_seller.popular_categories[].name	string	No
product_results.about_seller.popular_categories[].link	string	No
product_results.about_seller.reviews	object	Yes	Seller review data structure.
product_results.about_seller.reviews.all_products	object	No
product_results.about_seller.reviews.all_products.total	integer	No
product_results.about_seller.reviews.all_products.reviews	array	No
product_results.sections	array	Yes	Modular description or policy sections.
product_results.sold_out	boolean	Yes	Indicates whether the listing is currently out of stock / sold out.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/ebay/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0013 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/ebay/search

eBay Search

POST /api/v1/ebay/search

Scrape eBay search results including listings, prices, sellers, filters, categories, and pagination.

Overview

Scrape eBay search results including listings, prices, sellers, filters, categories, and pagination.

POST /api/v1/ebay/search

Method: POST Path: /api/v1/ebay/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code to localise results (e.g. US).
query	string	Required	Search query or full eBay search URL (e.g. 'macbook pro' or 'https://www.ebay.com/sch/i.html?_nkw=macbook+pro').

Request Example

eBay Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/ebay/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "search_metadata": {
    "status": "Success",
    "ebay_url": "https://example.com/..."
  },
  "search_information": {
    "total_results": 0,
    "total_results_text": "string",
    "query_displayed": "string"
  },
  "search_results": [
    {
      "position": 0,
      "itemId": "1234567890",
      "title": "string",
      "subtitle": "string",
      "is_new_listing": false,
      "seller": {
        "name": "string",
        "feedback": "string",
        "extracted_feedback": 0,
        "positive_feedback_percent": "string"
      },
      "condition": "string",
      "is_sponsored": false,
      "rating": "string",
      "reviews": "string",
      "reviews_link": "https://example.com/...",
      "buying_format": "string",
      "is_best_offer": false,
      "price": "string",
      "extracted_price": 0.0,
      "extracted_price_max": 0.0,
      "original_price": "string",
      "extracted_original_price": 0.0,
      "discount": "string",
      "link": "https://example.com/...",
      "items_sold": "string",
      "extracted_items_sold": 0,
      "watchers": "string",
      "extracted_watchers": 0,
      "bids": {
        "count": 0,
        "time_left": "string"
      },
      "promotion": "string",
      "stock_status": "string",
      "location": "string",
      "epid": "1234567890",
      "extensions": [
        "string"
      ],
      "shipping": "string",
      "extracted_shipping": 0.0,
      "delivery_days": "string",
      "is_free_return": false,
      "sold_date": "2026-01-01T12:00:00Z",
      "thumbnail": "https://example.com/...",
      "shipping_to": "string",
      "product_api_link": "https://example.com/..."
    }
  ],
  "popular_filters": [
    {
      "name": "string",
      "parameter": "string",
      "link": "https://example.com/..."
    }
  ],
  "categories": [
    {
      "name": "string",
      "id": 0,
      "link": "https://example.com/..."
    }
  ],
  "related_searches": [
    {
      "query": "string",
      "link": "https://example.com/..."
    }
  ],
  "inline_results": [
    {
      "title": "string",
      "items": [
        {
          "title": "string",
          "price": "string",
          "extracted_price": 0.0,
          "link": "https://example.com/..."
        }
      ]
    }
  ],
  "pagination": {
    "current": 0,
    "next": "https://example.com/...",
    "other_pages": {}
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "eBay Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
search_metadata	object	Yes	Metadata regarding the search request and endpoint execution.
search_metadata.status	string	Yes	Status of the scrape execution (e.g., 'Success' or 'Failed').
search_metadata.ebay_url	string	Yes	The normalized eBay search URL that was scraped.
search_information	object	Yes	Aggregate search statistics and query display information.
search_information.total_results	integer \| null	Yes	Parsed total number of search results matching the query.
search_information.total_results_text	string \| null	Yes	Raw string representing total results count (e.g., '35,000+ results for macbook pro').
search_information.query_displayed	string \| null	Yes	Displayed search query if altered or autocorrected by eBay.
search_results	array<object>	Yes	List of product listings found on the search result page.
search_results[].position	integer	Yes	1-indexed ranking position of the item in the search results.
search_results[].itemId	string	Yes	Unique eBay listing identification number.
search_results[].title	string	Yes	Full title of the product listing.
search_results[].subtitle	string	Yes	Secondary subtitle or specification summary (e.g., storage, color, warranty).
search_results[].is_new_listing	boolean	Yes	Indicates whether the listing is marked as newly listed.
search_results[].seller	object	Yes	Seller profile and feedback details.
search_results[].seller.name	string	Yes	Username / store name of the seller.
search_results[].seller.feedback	string	Yes	Raw feedback score string (e.g., '11K' or '427.1K').
search_results[].seller.extracted_feedback	integer \| null	Yes	Numeric feedback score parsed from the feedback string.
search_results[].seller.positive_feedback_percent	string	Yes	Percentage of positive feedback ratings (e.g., '99.2').
search_results[].condition	string	Yes	Item condition (e.g., 'Pre-Owned', 'Good - Refurbished', 'Open Box', 'Brand New').
search_results[].is_sponsored	boolean	Yes	True if the listing is an advertised/promoted placement.
search_results[].rating	string	Yes	Star rating out of 5 (e.g., '4.5', '5.0', or empty string if unrated).
search_results[].reviews	string	Yes	Review count or rating reviews string.
search_results[].reviews_link	string	Yes	Link to the customer reviews page.
search_results[].buying_format	string	Yes	Listing buying format (e.g., 'Buy It Now', 'or Best Offer', 'auction').
search_results[].is_best_offer	boolean	Yes	True if seller accepts best offers.
search_results[].price	string	Yes	Listing price string as displayed (e.g., '$539.00' or '$169.00 to $209.00').
search_results[].extracted_price	number \| null	Yes	Parsed lower-bound or fixed price as a float/integer.
search_results[].extracted_price_max	number \| null	Yes	Parsed upper-bound price if a range was displayed, otherwise null.
search_results[].original_price	string	Yes	Strikethrough / original listing price string (e.g., '$1,078.00').
search_results[].extracted_original_price	number \| null	Yes	Parsed numeric value of original/strikethrough price.
search_results[].discount	string	Yes	Discount percentage or text if displayed.
search_results[].link	string	Yes	Full direct URL to the eBay listing.
search_results[].items_sold	string	Yes	Sales volume string (e.g., '412 sold').
search_results[].extracted_items_sold	integer \| null	Yes	Parsed integer count of items sold.
search_results[].watchers	string	Yes	Watcher text (e.g., '8+ watchers', '14 watchers').
search_results[].extracted_watchers	integer \| null	Yes	Parsed integer count of watchers.
search_results[].bids	object \| null	Yes	Auction bidding details if listing is an auction.
search_results[].bids.count	integer	No	Number of bids placed.
search_results[].bids.time_left	string	No	Time remaining in auction.
search_results[].promotion	string	Yes	Promotional coupon or multi-buy offer (e.g., '$321.99 with coupon').
search_results[].stock_status	string	Yes	Stock urgency indicator (e.g., 'Last one', 'Almost gone').
search_results[].location	string	Yes	Item geographical origin (e.g., 'Located in United States').
search_results[].epid	string \| null	Yes	eBay Product ID (ePID) reference.
search_results[].extensions	array<string>	Yes	Badges and seller accreditation highlights.
search_results[].shipping	string	Yes	Shipping cost and estimated timeframe (e.g., 'Free delivery in 1-2 days').
search_results[].extracted_shipping	number \| null	Yes	Parsed shipping fee (0 for free shipping, or numeric dollar amount).
search_results[].delivery_days	string	Yes	Estimated delivery range in days (e.g., '1-2', '2-4').
search_results[].is_free_return	boolean	Yes	True if listing offers free returns.
search_results[].sold_date	string \| null	Yes	Date when item was sold if scraping completed/sold listings.
search_results[].thumbnail	string	Yes	Direct image URL for the product thumbnail.
search_results[].shipping_to	string	Yes	Target destination region for shipping.
search_results[].product_api_link	string	Yes	DataGuru internal API link to retrieve full product details for this item.
popular_filters	array<object>	Yes	Popular facet filters and aspect options extracted from the search page.
popular_filters[].name	string	Yes	Display label of the filter (e.g., '32 GB', 'Apple M1 Pro').
popular_filters[].parameter	string \| null	Yes	Query parameter representing the filter (e.g., 'RAM%20Size=32%20GB').
popular_filters[].link	string	Yes	URL to apply this filter.
categories	array<object>	Yes	Related eBay categories associated with the query.
categories[].name	string	Yes	Category name (e.g., 'Computers/Tablets & Networking').
categories[].id	integer	Yes	Numeric category ID (e.g., 58058).
categories[].link	string	Yes	URL to browse within this category.
related_searches	array<object>	Yes	Keyword search suggestions related to the current query.
related_searches[].query	string	Yes	Suggested search query (e.g., 'macbook air', 'macbook pro m1').
related_searches[].link	string	Yes	URL to execute the related search.
inline_results	array<object>	Yes	Special horizontal carousels embedded within the search page.
inline_results[].title	string	Yes	Carousel section title (e.g., 'Trending auctions', 'Quality pre-owned picks').
inline_results[].items	array<object>	Yes	List of products inside the inline carousel.
inline_results[].items[].title	string	Yes	Item title.
inline_results[].items[].price	string	Yes	Item display price.
inline_results[].items[].extracted_price	number \| null	Yes	Parsed numeric price.
inline_results[].items[].link	string	Yes	Item detail link.
pagination	object	Yes	Pagination navigation metadata and links to adjacent pages.
pagination.current	integer	Yes	Current active page number (e.g., 1).
pagination.next	string \| null	Yes	URL to the next page of search results.
pagination.other_pages	object	Yes	Key-value map of page numbers to their respective URLs.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/ebay/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0013 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/google/images

Google Images

POST /api/v1/google/images

Search Google Images by keyword or image URL and extract image results, thumbnails, sources, and dimensions.

Overview

Search Google Images by keyword or image URL and extract image results, thumbnails, sources, and dimensions.

POST /api/v1/google/images

Method: POST Path: /api/v1/google/images Category: Search Engine

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
country	string	Optional	Country code to localise results, e.g. us, gb, de.
image_url	string	Optional	Direct image URL for Google Lens visual search.
language	string	Optional	Interface language code, e.g. en, de, fr.
num_results	integer	Optional	Maximum number of image results to return (1-100).
page	integer	Optional	Page number of results.
query	string	Optional	Search query for Google Images, e.g. "apple iphone 15".
url	string	Optional	Full Google Images search URL.

Request Example

Google Images Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/google/images" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "us", "image_url": "example", "language": "en", "num_results": "20", "page": "1", "query": "example", "url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "total_time_taken": 0.0,
  "ads": [
    {
      "title": "string",
      "link": "https://example.com/..."
    }
  ],
  "images_results": [
    {
      "title": "string",
      "image": "string",
      "source": "string",
      "original": "string",
      "link": "https://example.com/...",
      "original_height": 0,
      "original_width": 0,
      "original_size": "string",
      "know_more_link": "https://example.com/...",
      "rank": 0
    }
  ],
  "pagination": {
    "current": "string",
    "next": "string",
    "page_no": {}
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Google Images",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
total_time_taken	number	Yes	Total scrape time in seconds.
ads	array<object>	Yes	Sponsored image or shopping ads, if any.
ads[].title	string	Yes	Ad text.
ads[].link	string	Yes	Ad URL.
images_results	array<object>	Yes	Image results in order, up to the requested limit.
images_results[].title	string	Yes	Image title.
images_results[].image	string	Yes	Thumbnail URL.
images_results[].source	string	Yes	Site the image comes from (e.g. 'www.imdb.com').
images_results[].original	string	Yes	Full-size image URL.
images_results[].link	string	Yes	Page containing the image.
images_results[].original_height	integer	Yes	Full-size image height in pixels (0 when unknown).
images_results[].original_width	integer	Yes	Full-size image width in pixels (0 when unknown).
images_results[].original_size	string	Yes	File size as shown by Google (e.g. '134KB'). Empty string when unknown.
images_results[].know_more_link	string	Yes	Google 'About this image' URL.
images_results[].rank	integer	Yes	Position in the results (1 = first).
pagination	object	No	Pagination links. Present only when Google returns a next page.
pagination.current	string	Yes	Current page number.
pagination.next	string	Yes	URL of the next results page.
pagination.page_no	object	Yes	Map of page number to page URL (e.g. {"2": "https://www.google.com/search?..."}).

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/google/images?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

country,image_url,language,num_results,page,query,url
us,example,en,20,1,example,example

Pricing & Rate Limits

Endpoint Pricing

$0.005 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/google/news

Google News

POST /api/v1/google/news

Search Google News articles with headlines, publishers, links, timestamps, and images.

Overview

Search Google News articles with headlines, publishers, links, timestamps, and images.

POST /api/v1/google/news

Method: POST Path: /api/v1/google/news Category: Search Engine

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
ceid	string	Optional	Google News edition identifier (e.g. US:en, GB:en).
country	string	Optional	Country code to localise results, e.g. US, GB, DE.
language	string	Optional	Interface language code, e.g. en-US, en, fr.
num_results	integer	Optional	Number of news results to return (1-100).
query	string	Required	Search query for news articles, e.g. "artificial intelligence".
topic	string	Optional	Google News topic ID (e.g. "TECHNOLOGY", "BUSINESS").
url	string	Optional	Full Google News URL to scrape directly.

Request Example

Google News Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/google/news" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ceid": "US:en", "country": "US", "language": "en-US", "num_results": "10", "query": "example", "topic": "example", "url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "search_information": {
    "query_displayed": "string",
    "url": "https://example.com/..."
  },
  "menu_links": [
    {
      "title": "string",
      "topic_token": "string",
      "link": "https://example.com/..."
    }
  ],
  "news_results": [
    {
      "title": "string",
      "snippet": "string",
      "author": "string",
      "source": "string",
      "lastUpdated": "string",
      "url": "https://example.com/...",
      "link": "https://example.com/...",
      "redirect_link": "https://example.com/...",
      "imgSrc": "string",
      "thumbnail": "string",
      "favicon": "string",
      "icon": "string",
      "authors": [
        "string"
      ],
      "date": "2026-01-01T12:00:00Z",
      "rank": 0
    }
  ],
  "articles": [
    {
      "article_data": {
        "headline": "string",
        "publisher_name": "string",
        "publisher_favicon_logo": "string",
        "publication_datetime": "string",
        "original_story_url": "https://example.com/...",
        "thumbnail_image": "string",
        "author": "string",
        "topic_tags": [
          "string"
        ],
        "related_coverage_clusters": [
          "string"
        ],
        "title": "string",
        "snippet": "string",
        "source": "string",
        "lastUpdated": "string",
        "url": "https://example.com/...",
        "link": "https://example.com/...",
        "redirect_link": "https://example.com/...",
        "imgSrc": "string",
        "thumbnail": "string",
        "favicon": "string",
        "icon": "string",
        "authors": [
          "string"
        ],
        "date": "2026-01-01T12:00:00Z",
        "rank": 0
      }
    }
  ],
  "pagination": {
    "current": "string",
    "next": "string"
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Google News",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
search_information	object	Yes	Search metadata.
search_information.query_displayed	string	Yes	Query or topic that was searched.
search_information.url	string	Yes	Google News URL that was requested.
menu_links	array<object>	Yes	Google News topic sections.
menu_links[].title	string	Yes	Section name (e.g. 'Technology').
menu_links[].topic_token	string	Yes	Google News topic token.
menu_links[].link	string	Yes	Google News URL for the section.
news_results	array<object>	Yes	News articles in a flat format, up to num_results.
news_results[].title	string	Yes	Article headline.
news_results[].snippet	string	Yes	Article description.
news_results[].author	string	Yes	First author. Empty string when unknown.
news_results[].source	string	Yes	Publisher name.
news_results[].lastUpdated	string	Yes	Publication time for display (e.g. '2 hours ago' or 'Jul 8, 2026').
news_results[].url	string	Yes	Article URL on the publisher's site (resolved from the Google News link when possible).
news_results[].link	string	Yes	Article URL (same as url).
news_results[].redirect_link	string	Yes	Original Google News link.
news_results[].imgSrc	string	Yes	Thumbnail URL. Empty string when none.
news_results[].thumbnail	string	Yes	Thumbnail URL (same as imgSrc).
news_results[].favicon	string	Yes	Publisher favicon URL.
news_results[].icon	string	Yes	Publisher icon URL.
news_results[].authors	array<string>	Yes	Article authors.
news_results[].date	string \| null	Yes	Publication time in ISO-8601 (e.g. '2026-10-20T10:00:00.000Z').
news_results[].rank	integer	Yes	Position in the results (1 = first).
articles	array<object>	Yes	The same articles with extra detail.
articles[].article_data	object	Yes	Detailed article data.
articles[].article_data.headline	string	Yes	Article headline.
articles[].article_data.publisher_name	string \| null	Yes	Publisher name.
articles[].article_data.publisher_favicon_logo	string \| null	Yes	Publisher logo URL.
articles[].article_data.publication_datetime	string \| null	Yes	Publication time as provided by Google.
articles[].article_data.original_story_url	string \| null	Yes	Article URL on the publisher's site (resolved when possible).
articles[].article_data.thumbnail_image	string \| null	Yes	Thumbnail URL.
articles[].article_data.author	string	Yes	First author. Empty string when unknown.
articles[].article_data.topic_tags	array<string>	Yes	Tags for the article (the query or topic searched).
articles[].article_data.related_coverage_clusters	array<string>	Yes	Related 'Full coverage' story names.
articles[].article_data.title	string	Yes	Article headline.
articles[].article_data.snippet	string	Yes	Article description.
articles[].article_data.source	string	Yes	Publisher name.
articles[].article_data.lastUpdated	string	Yes	Publication time for display (e.g. '2 hours ago' or 'Jul 8, 2026').
articles[].article_data.url	string	Yes	Article URL on the publisher's site (resolved from the Google News link when possible).
articles[].article_data.link	string	Yes	Article URL (same as url).
articles[].article_data.redirect_link	string	Yes	Original Google News link.
articles[].article_data.imgSrc	string	Yes	Thumbnail URL. Empty string when none.
articles[].article_data.thumbnail	string	Yes	Thumbnail URL (same as imgSrc).
articles[].article_data.favicon	string	Yes	Publisher favicon URL.
articles[].article_data.icon	string	Yes	Publisher icon URL.
articles[].article_data.authors	array<string>	Yes	Article authors.
articles[].article_data.date	string \| null	Yes	Publication time in ISO-8601 (e.g. '2026-10-20T10:00:00.000Z').
articles[].article_data.rank	integer	Yes	Position in the results (1 = first).
pagination	object	No	Present only when Google returns a next page.
pagination.current	string	Yes	Current page number.
pagination.next	string	Yes	URL of the next page.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/google/news?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,ceid,country,language,num_results,topic,url
example,US:en,US,en-US,10,example,example

Pricing & Rate Limits

Endpoint Pricing

$0.005 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/google/shopping

Google Shopping

POST /api/v1/google/shopping

Search Google Shopping for products, prices, merchants, ratings, reviews, and stock availability.

Overview

Search Google Shopping for products, prices, merchants, ratings, reviews, and stock availability.

POST /api/v1/google/shopping

Method: POST Path: /api/v1/google/shopping Category: Search Engine

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
country	string	Optional	Country code to localise results, e.g. us, gb, de.
language	string	Optional	Interface language code, e.g. en, de, fr.
num_results	integer	Optional	Maximum number of products to return (1-100).
query	string	Required	Search keyword for products or full Google Shopping search URL, e.g. "Sony WH-1000XM5".
url	string	Optional	Full Google Shopping search URL.

Request Example

Google Shopping Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/google/shopping" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "us", "language": "en", "num_results": "20", "query": "example", "url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "data": [
    {
      "product_feed": {
        "product_title": "string",
        "product_id": "1234567890",
        "thumbnail_images": [
          "string"
        ],
        "direct_merchant_links": [
          "string"
        ],
        "base_price": "string",
        "shipping_cost": 0.0,
        "total_calculated_price": "string",
        "currency": "USD",
        "seller_store_name": "string",
        "merchant_rating": 0.0,
        "product_rating": 0.0,
        "stock_status": "In stock",
        "discount_badges": [
          "string"
        ]
      }
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Google Shopping",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
data[].product_feed	object	Yes	Product details.
data[].product_feed.product_title	string	Yes	Product title.
data[].product_feed.product_id	string	Yes	Google product ID prefixed with 'gpid_'.
data[].product_feed.thumbnail_images	array<string>	Yes	Product image URLs.
data[].product_feed.direct_merchant_links	array<string>	Yes	Merchant or Google Shopping product page URLs.
data[].product_feed.base_price	string \| null	Yes	Item price with currency symbol (e.g. '$328.00').
data[].product_feed.shipping_cost	number \| null	Yes	Shipping cost as a number (0.0 for free or unknown shipping).
data[].product_feed.total_calculated_price	string \| null	Yes	Price plus shipping with currency symbol.
data[].product_feed.currency	string	Yes	ISO currency code (e.g. 'USD').
data[].product_feed.seller_store_name	string \| null	Yes	Merchant or store name.
data[].product_feed.merchant_rating	number \| null	Yes	Merchant rating out of 5.
data[].product_feed.product_rating	number \| null	Yes	Product rating out of 5.
data[].product_feed.stock_status	string	Yes	'In stock' or 'Out of stock'.
data[].product_feed.discount_badges	array<string>	Yes	Discount labels (e.g. '18% off').

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/google/shopping?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,country,language,num_results,url
example,us,en,20,example

Pricing & Rate Limits

Endpoint Pricing

$0.005 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/tiktok/shop

TikTok Shop

POST /api/v1/tiktok/shop

Scrape TikTok Shop product details, sale price, sales count, creator commission rate and seller profile.

Overview

Scrape TikTok Shop product details, sale price, sales count, creator commission rate and seller profile.

POST /api/v1/tiktok/shop

Method: POST Path: /api/v1/tiktok/shop Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
product_url	string	Required	TikTok Shop product URL or ID (e.g. https://shop.tiktok.com/view/product/1728493011)

Request Example

TikTok Shop Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/shop" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "tiktok_shop": {
    "product_id": "1234567890",
    "product_title": "string",
    "flash_sale_price": 0.0,
    "currency": "USD",
    "total_sold_units": 0,
    "commission_rate_for_creators_pct": 0.0,
    "shop_seller_profile": {
      "seller_name": "string",
      "seller_id": "1234567890"
    }
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "TikTok Shop",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
tiktok_shop	object	Yes	Extracted TikTok Shop product data.
tiktok_shop.product_id	string	Yes	TikTok Shop product or SPU ID.
tiktok_shop.product_title	string	Yes	Display title of the product in TikTok Shop.
tiktok_shop.flash_sale_price	number \| null	Yes	Current selling / flash sale price as float.
tiktok_shop.currency	string	Yes	Three-letter ISO currency code (e.g. 'USD').
tiktok_shop.total_sold_units	integer \| null	Yes	Total sales volume / sold units count.
tiktok_shop.commission_rate_for_creators_pct	number \| null	Yes	Affiliate commission rate percentage for creators (e.g. 15.0 for 15%).
tiktok_shop.shop_seller_profile	object	Yes	Shop merchant and seller information.
tiktok_shop.shop_seller_profile.seller_name	string	Yes	Official name of the shop or merchant.
tiktok_shop.shop_seller_profile.seller_id	string	Yes	Merchant / seller numeric or alphanumeric identifier.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/shop?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0009 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/tiktok/search

TikTok Search

POST /api/v1/tiktok/search

Search TikTok for videos by keyword or hashtag with metrics, music details, and media URLs.

Overview

Search TikTok for videos by keyword or hashtag with metrics, music details, and media URLs.

POST /api/v1/tiktok/search

Method: POST Path: /api/v1/tiktok/search Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Number of video results to return.
query	string	Required	Search keyword, hashtag or search URL (e.g. cooking or

Request Example

TikTok Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "5", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "tiktok_search": {
    "query": "string",
    "search_url": "https://example.com/...",
    "total_results": 0,
    "results": [
      {
        "video_id": "1234567890",
        "video_url": "https://example.com/...",
        "description": "string",
        "created_at": "2026-01-01T12:00:00Z",
        "music_id": "1234567890",
        "music_title": "string",
        "music_author": "string",
        "music_url": "https://example.com/...",
        "duration": 0,
        "cover_image_url": "https://example.com/...",
        "dynamic_cover_url": "https://example.com/...",
        "download_url": "https://example.com/...",
        "play_url": "https://example.com/...",
        "view_count": 0,
        "like_count": 0,
        "comment_count": 0,
        "share_count": 0,
        "collect_save_count": 0
      }
    ]
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "TikTok Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
tiktok_search	object	Yes	Search results container for TikTok query.
tiktok_search.query	string	Yes	Cleaned search term or query string.
tiktok_search.search_url	string	Yes	Canonical TikTok search URL.
tiktok_search.total_results	integer	Yes	Count of video search results returned.
tiktok_search.results	array<object>	Yes	List of video items matching the search query.
tiktok_search.results[].video_id	string	Yes	Numeric video ID.
tiktok_search.results[].video_url	string	Yes	Full TikTok post URL link.
tiktok_search.results[].description	string	Yes	Video caption text.
tiktok_search.results[].created_at	string \| null	Yes	Video creation timestamp in UTC ISO-8601 format.
tiktok_search.results[].music_id	string \| null	No	Background music ID.
tiktok_search.results[].music_title	string \| null	No	Music track title.
tiktok_search.results[].music_author	string \| null	No	Music artist name.
tiktok_search.results[].music_url	string \| null	No	Direct audio stream URL.
tiktok_search.results[].duration	integer \| null	Yes	Video duration in seconds.
tiktok_search.results[].cover_image_url	string	Yes	Static video thumbnail poster URL.
tiktok_search.results[].dynamic_cover_url	string \| null	No	Animated dynamic cover preview URL.
tiktok_search.results[].download_url	string \| null	No	Direct downloadable video stream URL.
tiktok_search.results[].play_url	string	Yes	Direct streaming video URL.
tiktok_search.results[].view_count	integer \| null	No	Total plays / views count.
tiktok_search.results[].like_count	integer \| null	No	Total likes count.
tiktok_search.results[].comment_count	integer \| null	No	Total comments count.
tiktok_search.results[].share_count	integer \| null	No	Total shares count.
tiktok_search.results[].collect_save_count	integer \| null	No	Total favorites / bookmarks count.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/tiktok/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit
example,5

Pricing & Rate Limits

Endpoint Pricing

$0.0009 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/x/profile

X (Twitter) Profile

POST /api/v1/x/profile

Get a public X (Twitter) profile: name, handle, bio, followers, following, verified status, and profile picture.

Overview

Get a public X (Twitter) profile: name, handle, bio, followers, following, verified status, and profile picture.

POST /api/v1/x/profile

Method: POST Path: /api/v1/x/profile Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
profile_url	string	Required	Public X profile URL or username, e.g. https://x.com/elonmusk

Request Example

X (Twitter) Profile Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/x/profile" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "user_profile": {
    "username": "string",
    "full_name": "string",
    "biography": "string",
    "external_link": "https://example.com/...",
    "follower_count": 0,
    "following_count": 0,
    "total_post_count": 0,
    "account_category": "string",
    "verified_badge": false,
    "profile_picture_hd_url": "https://example.com/...",
    "unique_id": "1234567890",
    "nickname": "string",
    "total_heart_like_count": 0,
    "video_count": 0,
    "screen_name": "string",
    "location": "string",
    "join_date": "2026-01-01T12:00:00Z",
    "verified_type": "Blue",
    "pinned_tweet_id": "1234567890"
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "X (Twitter) Profile",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
user_profile	object	Yes	Public profile data for the requested X account.
user_profile.username	string	Yes	Account handle without the '@' (e.g. 'elonmusk').
user_profile.full_name	string	Yes	Display name; falls back to the handle when not found.
user_profile.biography	string	Yes	Profile bio text. Empty string when not found.
user_profile.external_link	string	Yes	Expanded website link from the bio. Empty string when none.
user_profile.follower_count	integer \| null	Yes	Number of followers.
user_profile.following_count	integer \| null	Yes	Number of accounts followed.
user_profile.total_post_count	integer \| null	Yes	Total number of posts (tweets).
user_profile.account_category	string	Yes	Affiliate label or account category. Empty string when none.
user_profile.verified_badge	boolean	Yes	True if the account has any verification badge (blue, government or business).
user_profile.profile_picture_hd_url	string	Yes	Profile picture URL at 400x400 resolution.
user_profile.unique_id	string	Yes	Numeric X user ID (rest ID) as a string. Empty string when not found.
user_profile.nickname	string	Yes	Display name (same as full_name).
user_profile.total_heart_like_count	integer \| null	Yes	Number of posts the account has liked.
user_profile.video_count	integer \| null	Yes	Number of media posts.
user_profile.screen_name	string	Yes	Account handle (same as username).
user_profile.location	string	Yes	Location from the profile. Empty string when none.
user_profile.join_date	string	Yes	Date the account joined, YYYY-MM-DD (day is 01 when only month and year are known). Empty string when not found.
user_profile.verified_type	string	Yes	Badge type: 'Blue', 'Government' or 'Business'. Empty string when not verified.
user_profile.pinned_tweet_id	string	Yes	ID of the pinned post. Empty string when none.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/x/profile?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

profile_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0025 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/x/search

X (Twitter) Search

POST /api/v1/x/search

Search X (Twitter) posts and accounts by keyword or query.

Overview

Search X (Twitter) posts and accounts by keyword or query.

POST /api/v1/x/search

Method: POST Path: /api/v1/x/search Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (1-50).
query	string	Required	Search query or topic, e.g. "openai" or "AI".

Request Example

X (Twitter) Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/x/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "5", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "x_search": {
    "query": "string",
    "search_url": "https://example.com/...",
    "total_results": 0,
    "results": [
      {
        "post_id": "1234567890",
        "post_url": "https://example.com/...",
        "author_username": "string",
        "author_name": "string",
        "author_id": "1234567890",
        "author_profile_image": "string",
        "text": "string",
        "embedded_hashtags": [
          "string"
        ],
        "create_time": "string",
        "reply_count": 0,
        "retweet_count": 0,
        "like_count": 0,
        "quote_count": 0,
        "view_count": 0,
        "save_count": 0,
        "is_retweet": false,
        "is_pinned": false
      }
    ]
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "X (Twitter) Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
x_search	object	Yes	Search results for the query.
x_search.query	string	Yes	Search query used (taken from the 'q' parameter when a search URL is given).
x_search.search_url	string	Yes	X search URL for the query.
x_search.total_results	integer	Yes	Number of posts returned in results.
x_search.results	array<object>	Yes	Matching posts, up to the requested limit.
x_search.results[].post_id	string	Yes	Numeric post (tweet) ID.
x_search.results[].post_url	string	Yes	Link to the post on x.com.
x_search.results[].author_username	string	Yes	Author handle without the '@'.
x_search.results[].author_name	string	Yes	Author display name.
x_search.results[].author_id	string	Yes	Numeric author user ID. Empty string when not found.
x_search.results[].author_profile_image	string	Yes	Author profile picture URL (400x400). Empty string when not found.
x_search.results[].text	string	Yes	Full post text.
x_search.results[].embedded_hashtags	array<string>	Yes	Hashtags in the post, without '#'.
x_search.results[].create_time	string	Yes	Post time in UTC ISO-8601 (YYYY-MM-DDTHH:MM:SSZ). Empty string when unknown.
x_search.results[].reply_count	integer \| null	Yes	Number of replies.
x_search.results[].retweet_count	integer \| null	Yes	Number of reposts.
x_search.results[].like_count	integer \| null	Yes	Number of likes.
x_search.results[].quote_count	integer \| null	Yes	Number of quote posts.
x_search.results[].view_count	integer \| null	Yes	Number of views.
x_search.results[].save_count	integer \| null	Yes	Number of bookmarks.
x_search.results[].is_retweet	boolean	Yes	True if the post is a repost.
x_search.results[].is_pinned	boolean	Yes	True if the post is pinned on the author's profile.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/x/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit
example,5

Pricing & Rate Limits

Endpoint Pricing

$0.001 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/x/trends

X (Twitter) Trends

POST /api/v1/x/trends

Get trending hashtags, topics, and discussions on X (Twitter) by country or worldwide.

Overview

Get trending hashtags, topics, and discussions on X (Twitter) by country or worldwide.

POST /api/v1/x/trends

Method: POST Path: /api/v1/x/trends Category: Social Media

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
include_tweets	boolean	Optional	Whether to include sample tweets for the top trends.
limit	integer	Optional	Maximum number of trending items to return (1-100).
location	string	Optional	Country name, country code, or "worldwide" (e.g. us, uk, worldwide).
tweets_limit	integer	Optional	Number of sample tweets per trend if include_tweets is true (1-10).

Request Example

X (Twitter) Trends Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/x/trends" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"include_tweets": "False", "limit": "50", "location": "worldwide", "tweets_limit": "3"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "x_trends": {
    "location": "string",
    "location_slug": "string",
    "source_url": "https://example.com/...",
    "scraped_at": "2026-01-01T12:00:00Z",
    "total_trends": 0,
    "total_hashtags": 0,
    "total_topics": 0,
    "top_hashtags": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ],
        "hashtag": "string",
        "overall_rank": 0
      }
    ],
    "popular_topics": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ],
        "topic": "string",
        "overall_rank": 0
      }
    ],
    "all_trends": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ]
      }
    ],
    "longest_trending": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ]
      }
    ],
    "new_trends": [
      {
        "name": "string",
        "rank": 0,
        "type": "hashtag",
        "post_url": "https://example.com/..."
      }
    ],
    "hourly_timeline": [
      {
        "time": "string",
        "top_trends": [
          "string"
        ]
      }
    ]
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "X (Twitter) Trends",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
x_trends	object	Yes	Current X trends for the location.
x_trends.location	string	Yes	Location name (e.g. 'United States').
x_trends.location_slug	string	Yes	Normalised location slug (e.g. 'united-states', 'worldwide').
x_trends.source_url	string	Yes	Trend source page the data was read from.
x_trends.scraped_at	string	Yes	Scrape time in UTC ISO-8601.
x_trends.total_trends	integer	Yes	Number of trends in all_trends.
x_trends.total_hashtags	integer	Yes	Number of hashtag trends found.
x_trends.total_topics	integer	Yes	Number of topic trends found.
x_trends.top_hashtags	array<object>	Yes	Hashtag trends, best first.
x_trends.top_hashtags[].rank	integer	Yes	Position in this list (1 = top).
x_trends.top_hashtags[].name	string	Yes	Trend name as shown on X, including '#' for hashtags.
x_trends.top_hashtags[].type	string	Yes	'hashtag' or 'topic'.
x_trends.top_hashtags[].clean_name	string	Yes	Trend name without a leading '#'.
x_trends.top_hashtags[].description	string	Yes	Representative post text or news headline for the trend. Empty string when none was found.
x_trends.top_hashtags[].post_url	string	Yes	X search URL for the trend.
x_trends.top_hashtags[].current_rank	integer	Yes	Current overall rank.
x_trends.top_hashtags[].peak_rank	integer	Yes	Best rank reached in the recent hourly snapshots.
x_trends.top_hashtags[].hours_trending	integer	Yes	Number of recent hourly snapshots the trend appeared in.
x_trends.top_hashtags[].rank_change	string	Yes	Change since the previous hour: '+N', '-N', '=' or 'NEW'.
x_trends.top_hashtags[].status	string	Yes	Movement since the previous hour.
x_trends.top_hashtags[].tweet_count	string \| null	No	Post volume as shown by the source (e.g. '25K'). Only present for some sources.
x_trends.top_hashtags[].sample_tweets	array<object>	No	Sample posts for the trend. Only present on the top 3 trends of all_trends when include_tweets is true.
x_trends.top_hashtags[].sample_tweets[].post_id	string	Yes	Numeric post (tweet) ID.
x_trends.top_hashtags[].sample_tweets[].post_url	string	Yes	Link to the post on x.com.
x_trends.top_hashtags[].sample_tweets[].author_username	string	Yes	Author handle without the '@'.
x_trends.top_hashtags[].sample_tweets[].author_name	string	Yes	Author display name.
x_trends.top_hashtags[].sample_tweets[].author_id	string	Yes	Numeric author user ID. Empty string when not found.
x_trends.top_hashtags[].sample_tweets[].author_profile_image	string	Yes	Author profile picture URL (400x400). Empty string when not found.
x_trends.top_hashtags[].sample_tweets[].text	string	Yes	Full post text.
x_trends.top_hashtags[].sample_tweets[].embedded_hashtags	array<string>	Yes	Hashtags in the post, without '#'.
x_trends.top_hashtags[].sample_tweets[].create_time	string	Yes	Post time in UTC ISO-8601 (YYYY-MM-DDTHH:MM:SSZ). Empty string when unknown.
x_trends.top_hashtags[].sample_tweets[].reply_count	integer \| null	Yes	Number of replies.
x_trends.top_hashtags[].sample_tweets[].retweet_count	integer \| null	Yes	Number of reposts.
x_trends.top_hashtags[].sample_tweets[].like_count	integer \| null	Yes	Number of likes.
x_trends.top_hashtags[].sample_tweets[].quote_count	integer \| null	Yes	Number of quote posts.
x_trends.top_hashtags[].sample_tweets[].view_count	integer \| null	Yes	Number of views.
x_trends.top_hashtags[].sample_tweets[].save_count	integer \| null	Yes	Number of bookmarks.
x_trends.top_hashtags[].sample_tweets[].is_retweet	boolean	Yes	True if the post is a repost.
x_trends.top_hashtags[].sample_tweets[].is_pinned	boolean	Yes	True if the post is pinned on the author's profile.
x_trends.top_hashtags[].hashtag	string	Yes	Hashtag including '#'.
x_trends.top_hashtags[].overall_rank	integer	Yes	Rank among all trends (rank is the position among hashtags).
x_trends.popular_topics	array<object>	Yes	Non-hashtag topic trends, best first.
x_trends.popular_topics[].rank	integer	Yes	Position in this list (1 = top).
x_trends.popular_topics[].name	string	Yes	Trend name as shown on X, including '#' for hashtags.
x_trends.popular_topics[].type	string	Yes	'hashtag' or 'topic'.
x_trends.popular_topics[].clean_name	string	Yes	Trend name without a leading '#'.
x_trends.popular_topics[].description	string	Yes	Representative post text or news headline for the trend. Empty string when none was found.
x_trends.popular_topics[].post_url	string	Yes	X search URL for the trend.
x_trends.popular_topics[].current_rank	integer	Yes	Current overall rank.
x_trends.popular_topics[].peak_rank	integer	Yes	Best rank reached in the recent hourly snapshots.
x_trends.popular_topics[].hours_trending	integer	Yes	Number of recent hourly snapshots the trend appeared in.
x_trends.popular_topics[].rank_change	string	Yes	Change since the previous hour: '+N', '-N', '=' or 'NEW'.
x_trends.popular_topics[].status	string	Yes	Movement since the previous hour.
x_trends.popular_topics[].tweet_count	string \| null	No	Post volume as shown by the source (e.g. '25K'). Only present for some sources.
x_trends.popular_topics[].sample_tweets	array<object>	No	Sample posts for the trend. Only present on the top 3 trends of all_trends when include_tweets is true.
x_trends.popular_topics[].sample_tweets[].post_id	string	Yes	Numeric post (tweet) ID.
x_trends.popular_topics[].sample_tweets[].post_url	string	Yes	Link to the post on x.com.
x_trends.popular_topics[].sample_tweets[].author_username	string	Yes	Author handle without the '@'.
x_trends.popular_topics[].sample_tweets[].author_name	string	Yes	Author display name.
x_trends.popular_topics[].sample_tweets[].author_id	string	Yes	Numeric author user ID. Empty string when not found.
x_trends.popular_topics[].sample_tweets[].author_profile_image	string	Yes	Author profile picture URL (400x400). Empty string when not found.
x_trends.popular_topics[].sample_tweets[].text	string	Yes	Full post text.
x_trends.popular_topics[].sample_tweets[].embedded_hashtags	array<string>	Yes	Hashtags in the post, without '#'.
x_trends.popular_topics[].sample_tweets[].create_time	string	Yes	Post time in UTC ISO-8601 (YYYY-MM-DDTHH:MM:SSZ). Empty string when unknown.
x_trends.popular_topics[].sample_tweets[].reply_count	integer \| null	Yes	Number of replies.
x_trends.popular_topics[].sample_tweets[].retweet_count	integer \| null	Yes	Number of reposts.
x_trends.popular_topics[].sample_tweets[].like_count	integer \| null	Yes	Number of likes.
x_trends.popular_topics[].sample_tweets[].quote_count	integer \| null	Yes	Number of quote posts.
x_trends.popular_topics[].sample_tweets[].view_count	integer \| null	Yes	Number of views.
x_trends.popular_topics[].sample_tweets[].save_count	integer \| null	Yes	Number of bookmarks.
x_trends.popular_topics[].sample_tweets[].is_retweet	boolean	Yes	True if the post is a repost.
x_trends.popular_topics[].sample_tweets[].is_pinned	boolean	Yes	True if the post is pinned on the author's profile.
x_trends.popular_topics[].topic	string	Yes	Topic name.
x_trends.popular_topics[].overall_rank	integer	Yes	Rank among all trends (rank is the position among topics).
x_trends.all_trends	array<object>	Yes	All trends in rank order, up to the requested limit.
x_trends.all_trends[].rank	integer	Yes	Position in this list (1 = top).
x_trends.all_trends[].name	string	Yes	Trend name as shown on X, including '#' for hashtags.
x_trends.all_trends[].type	string	Yes	'hashtag' or 'topic'.
x_trends.all_trends[].clean_name	string	Yes	Trend name without a leading '#'.
x_trends.all_trends[].description	string	Yes	Representative post text or news headline for the trend. Empty string when none was found.
x_trends.all_trends[].post_url	string	Yes	X search URL for the trend.
x_trends.all_trends[].current_rank	integer	Yes	Current overall rank.
x_trends.all_trends[].peak_rank	integer	Yes	Best rank reached in the recent hourly snapshots.
x_trends.all_trends[].hours_trending	integer	Yes	Number of recent hourly snapshots the trend appeared in.
x_trends.all_trends[].rank_change	string	Yes	Change since the previous hour: '+N', '-N', '=' or 'NEW'.
x_trends.all_trends[].status	string	Yes	Movement since the previous hour.
x_trends.all_trends[].tweet_count	string \| null	No	Post volume as shown by the source (e.g. '25K'). Only present for some sources.
x_trends.all_trends[].sample_tweets	array<object>	No	Sample posts for the trend. Only present on the top 3 trends of all_trends when include_tweets is true.
x_trends.all_trends[].sample_tweets[].post_id	string	Yes	Numeric post (tweet) ID.
x_trends.all_trends[].sample_tweets[].post_url	string	Yes	Link to the post on x.com.
x_trends.all_trends[].sample_tweets[].author_username	string	Yes	Author handle without the '@'.
x_trends.all_trends[].sample_tweets[].author_name	string	Yes	Author display name.
x_trends.all_trends[].sample_tweets[].author_id	string	Yes	Numeric author user ID. Empty string when not found.
x_trends.all_trends[].sample_tweets[].author_profile_image	string	Yes	Author profile picture URL (400x400). Empty string when not found.
x_trends.all_trends[].sample_tweets[].text	string	Yes	Full post text.
x_trends.all_trends[].sample_tweets[].embedded_hashtags	array<string>	Yes	Hashtags in the post, without '#'.
x_trends.all_trends[].sample_tweets[].create_time	string	Yes	Post time in UTC ISO-8601 (YYYY-MM-DDTHH:MM:SSZ). Empty string when unknown.
x_trends.all_trends[].sample_tweets[].reply_count	integer \| null	Yes	Number of replies.
x_trends.all_trends[].sample_tweets[].retweet_count	integer \| null	Yes	Number of reposts.
x_trends.all_trends[].sample_tweets[].like_count	integer \| null	Yes	Number of likes.
x_trends.all_trends[].sample_tweets[].quote_count	integer \| null	Yes	Number of quote posts.
x_trends.all_trends[].sample_tweets[].view_count	integer \| null	Yes	Number of views.
x_trends.all_trends[].sample_tweets[].save_count	integer \| null	Yes	Number of bookmarks.
x_trends.all_trends[].sample_tweets[].is_retweet	boolean	Yes	True if the post is a repost.
x_trends.all_trends[].sample_tweets[].is_pinned	boolean	Yes	True if the post is pinned on the author's profile.
x_trends.longest_trending	array<object>	Yes	Trends that have stayed on the list the longest (up to 10).
x_trends.longest_trending[].rank	integer	Yes	Position in this list (1 = top).
x_trends.longest_trending[].name	string	Yes	Trend name as shown on X, including '#' for hashtags.
x_trends.longest_trending[].type	string	Yes	'hashtag' or 'topic'.
x_trends.longest_trending[].clean_name	string	Yes	Trend name without a leading '#'.
x_trends.longest_trending[].description	string	Yes	Representative post text or news headline for the trend. Empty string when none was found.
x_trends.longest_trending[].post_url	string	Yes	X search URL for the trend.
x_trends.longest_trending[].current_rank	integer	Yes	Current overall rank.
x_trends.longest_trending[].peak_rank	integer	Yes	Best rank reached in the recent hourly snapshots.
x_trends.longest_trending[].hours_trending	integer	Yes	Number of recent hourly snapshots the trend appeared in.
x_trends.longest_trending[].rank_change	string	Yes	Change since the previous hour: '+N', '-N', '=' or 'NEW'.
x_trends.longest_trending[].status	string	Yes	Movement since the previous hour.
x_trends.longest_trending[].tweet_count	string \| null	No	Post volume as shown by the source (e.g. '25K'). Only present for some sources.
x_trends.longest_trending[].sample_tweets	array<object>	No	Sample posts for the trend. Only present on the top 3 trends of all_trends when include_tweets is true.
x_trends.longest_trending[].sample_tweets[].post_id	string	Yes	Numeric post (tweet) ID.
x_trends.longest_trending[].sample_tweets[].post_url	string	Yes	Link to the post on x.com.
x_trends.longest_trending[].sample_tweets[].author_username	string	Yes	Author handle without the '@'.
x_trends.longest_trending[].sample_tweets[].author_name	string	Yes	Author display name.
x_trends.longest_trending[].sample_tweets[].author_id	string	Yes	Numeric author user ID. Empty string when not found.
x_trends.longest_trending[].sample_tweets[].author_profile_image	string	Yes	Author profile picture URL (400x400). Empty string when not found.
x_trends.longest_trending[].sample_tweets[].text	string	Yes	Full post text.
x_trends.longest_trending[].sample_tweets[].embedded_hashtags	array<string>	Yes	Hashtags in the post, without '#'.
x_trends.longest_trending[].sample_tweets[].create_time	string	Yes	Post time in UTC ISO-8601 (YYYY-MM-DDTHH:MM:SSZ). Empty string when unknown.
x_trends.longest_trending[].sample_tweets[].reply_count	integer \| null	Yes	Number of replies.
x_trends.longest_trending[].sample_tweets[].retweet_count	integer \| null	Yes	Number of reposts.
x_trends.longest_trending[].sample_tweets[].like_count	integer \| null	Yes	Number of likes.
x_trends.longest_trending[].sample_tweets[].quote_count	integer \| null	Yes	Number of quote posts.
x_trends.longest_trending[].sample_tweets[].view_count	integer \| null	Yes	Number of views.
x_trends.longest_trending[].sample_tweets[].save_count	integer \| null	Yes	Number of bookmarks.
x_trends.longest_trending[].sample_tweets[].is_retweet	boolean	Yes	True if the post is a repost.
x_trends.longest_trending[].sample_tweets[].is_pinned	boolean	Yes	True if the post is pinned on the author's profile.
x_trends.new_trends	array<object>	Yes	Trends that are new since the previous hour.
x_trends.new_trends[].name	string	Yes	Trend name.
x_trends.new_trends[].rank	integer	Yes	Current overall rank.
x_trends.new_trends[].type	string	Yes	'hashtag' or 'topic'.
x_trends.new_trends[].post_url	string	Yes	X search URL for the trend.
x_trends.hourly_timeline	array<object>	Yes	Top trends in each recent hourly snapshot (up to 12).
x_trends.hourly_timeline[].time	string	Yes	Snapshot label as shown by the source.
x_trends.hourly_timeline[].top_trends	array<string>	Yes	Top trend names in that hour (up to 10).

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/x/trends?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

include_tweets,limit,location,tweets_limit
False,50,worldwide,3

Pricing & Rate Limits

Endpoint Pricing

$0.003 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/bestbuy/products/details

Best Buy Product Details

POST /api/v1/bestbuy/products/details

Get product details from a BestBuy.com product URL, including price, ratings, specifications, images and availability.

Overview

Get product details from a BestBuy.com product URL, including price, ratings, specifications, images and availability.

POST /api/v1/bestbuy/products/details

Method: POST Path: /api/v1/bestbuy/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code (default US).
product_url	string	Required	Full Best Buy product URL (e.g. https://www.bestbuy.com/site/hp-14-laptop.../6667483.p?skuId=6667483).

Request Example

Best Buy Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/bestbuy/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "sku": "string",
  "title": "string",
  "brand": "string",
  "model_number": "string",
  "upc": "string",
  "url": "https://example.com/...",
  "categories": [
    "string"
  ],
  "price": {
    "current_price": 0.0,
    "regular_price": 0.0,
    "savings": 0.0,
    "savings_percentage": 0.0,
    "currency": "USD",
    "open_box_options": [
      {
        "condition": "string",
        "price": 0.0,
        "pdp_url": "https://example.com/...",
        "availability": "string"
      }
    ]
  },
  "rating": {
    "average_rating": 0.0,
    "review_count": 0,
    "review_summary": "string"
  },
  "qa_stats": {
    "answered_questions": 0
  },
  "availability": {
    "in_stock": false,
    "status": "string"
  },
  "description": "string",
  "bullet_descriptions": [
    "string"
  ],
  "specifications": {},
  "specifications_detailed": [
    {
      "category": "string",
      "name": "string",
      "value": "string",
      "definition": "string"
    }
  ],
  "images": [
    "string"
  ],
  "variants": [
    {
      "bsin": "string",
      "sku": "string",
      "options": [
        {
          "name": "string",
          "value": "string"
        }
      ]
    }
  ],
  "badges": [
    "string"
  ],
  "seller": {
    "name": "Best Buy",
    "type": "1P"
  },
  "return_policy_url": "https://example.com/...",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Best Buy Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
sku	string	Yes	Best Buy unique SKU identifier.
title	string	Yes	Full product title cleaned of HTML tags and entities.
brand	string \| null	No	Manufacturer or brand name.
model_number	string \| null	No	Manufacturer model number.
upc	string \| null	No	Universal Product Code (UPC) barcode.
url	string	Yes	Canonical Best Buy product page URL.
categories	array<string>	No	Full breadcrumb category lineage.
price	object	Yes
price.current_price	number \| null	Yes	Current selling price in USD.
price.regular_price	number \| null	No	Original list price before discount.
price.savings	number \| null	No	Monetary dollar savings.
price.savings_percentage	number \| null	No	Percentage discount off regular price.
price.currency	string	Yes
price.open_box_options	array<object>	No	Available certified open-box pricing and conditions.
price.open_box_options[].condition	string	No	Condition descriptor (e.g. Open-Box Excellent, Open-Box Fair).
price.open_box_options[].price	number \| null	No
price.open_box_options[].pdp_url	string \| null	No
price.open_box_options[].availability	string	No
rating	object	Yes
rating.average_rating	number \| null	No	Average review score on a 5-star scale.
rating.review_count	integer \| null	No	Total count of user reviews.
rating.review_summary	string \| null	No	AI-generated synthesized customer review summary.
qa_stats	object	No
qa_stats.answered_questions	integer \| null	No	Total number of answered customer Q&As.
availability	object	Yes
availability.in_stock	boolean	Yes	True if product can be ordered/added to cart.
availability.status	string	Yes	Availability state (e.g. InStock, OutOfStock).
description	string \| null	No	Full product overview narrative text.
bullet_descriptions	array<string>	No	Key feature highlights.
specifications	object	No	Grouped specifications categorized by section.
specifications_detailed	array<object>	No	Granular specification list with names, values, and definitions.
specifications_detailed[].category	string	No
specifications_detailed[].name	string	No
specifications_detailed[].value	string \| number \| boolean \| null	No
specifications_detailed[].definition	string \| null	No
images	array<string>	No	High resolution product image gallery URLs.
variants	array<object>	No	Available product variations (colors, capacities, sizes).
variants[].bsin	string \| null	No
variants[].sku	string \| null	No
variants[].options	array<object>	No
variants[].options[].name	string	No
variants[].options[].value	string	No
badges	array<string>	No	Badges and awards (e.g. Best Selling, Trending Deal).
seller	object	No
seller.name	string	No
seller.type	string	No
return_policy_url	string	No	Direct URL to Best Buy return and exchange policy.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/bestbuy/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.02 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/target/products/search

Target Product Search

POST /api/v1/target/products/search

Search Target.com by keyword and get matching products with titles, prices, ratings, review counts, images, and specifications.

Overview

Search Target.com by keyword and get matching products with titles, prices, ratings, review counts, images, and specifications.

POST /api/v1/target/products/search

Method: POST Path: /api/v1/target/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return.
location	string	Optional	Two-letter country code (default US).
query	string	Required	Search keywords, e.g. "airpods"

Request Example

Target Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/target/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "total_results": 0,
  "returned_results": 0,
  "source": "string",
  "results": [
    {
      "tcin": "string",
      "title": "string",
      "brand": "string",
      "url": "https://example.com/...",
      "price": {
        "formatted_current_price": "string",
        "formatted_comparison_price": "string",
        "current_retail": 0.0,
        "reg_retail": 0.0,
        "price_type": "string",
        "currency": "USD",
        "on_sale": false
      },
      "rating": 0.0,
      "reviews_count": 0,
      "image": "string",
      "badges": [
        "string"
      ],
      "bullet_descriptions": [
        "string"
      ],
      "specifications": {},
      "dpci": "string",
      "upc": "string",
      "fulfillment": "string",
      "in_stock": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Target Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	Original search keyword or term queried.
total_results	integer	Yes	Estimated total number of matching products on Target.
returned_results	integer	No	Number of product items parsed and returned in this response.
source	string	No	Extraction method utilized (e.g. target_web_api or target_html_xpath).
results	array<object>	Yes	List of product cards matching the query.
results[].tcin	string	Yes	Target Circle / Item Number identifier.
results[].title	string	Yes	Cleaned product display title.
results[].brand	string	No	Brand manufacturer name.
results[].url	string	Yes	Full product URL on Target.com.
results[].price	object	Yes	Pricing information object.
results[].price.formatted_current_price	string	No	Formatted price text, e.g. '$149.99'.
results[].price.formatted_comparison_price	string	No	Formatted comparison or regular price if discounted.
results[].price.current_retail	number \| null	No	Numeric current retail price.
results[].price.reg_retail	number \| null	No	Numeric regular retail price before sale.
results[].price.price_type	string	No	Price condition type, e.g. 'reg' or 'sale'.
results[].price.currency	string	No	Three-letter currency code (USD).
results[].price.on_sale	boolean	No	True if product currently has a discount or sale.
results[].rating	number \| null	No	Average review score on a 5.0 scale.
results[].reviews_count	integer	No	Total user review count.
results[].image	string	No	Primary product image URL.
results[].badges	array<string>	No	Badges and promotional tags, e.g. 'Bestseller' or 'Rarely returned'.
results[].bullet_descriptions	array<string>	No	Clean list of bullet points and specifications without HTML tags.
results[].specifications	object	No	Key-value dictionary of parsed item specifications.
results[].dpci	string	No	Target DPCI inventory identifier.
results[].upc	string	No	UPC or primary barcode.
results[].fulfillment	string	No	Fulfillment and shipping availability info.
results[].in_stock	boolean	No	Item in-stock availability flag.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/target/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,24,US

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/target/products/details

Target Product Details

POST /api/v1/target/products/details

Get product details from a Target.com product URL, including price, ratings, specifications, images and availability.

Overview

Get product details from a Target.com product URL, including price, ratings, specifications, images and availability.

POST /api/v1/target/products/details

Method: POST Path: /api/v1/target/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code (default US).
product_url	string	Required	Full Target product URL (e.g. https://www.target.com/p/.../-/A-93606140).

Request Example

Target Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/target/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "tcin": "string",
  "dpci": "string",
  "upc": "string",
  "title": "string",
  "brand": {
    "name": "string",
    "id": "1234567890",
    "canonical_url": "https://example.com/..."
  },
  "url": "https://example.com/...",
  "breadcrumbs": [
    "string"
  ],
  "category": {
    "parent_category_id": "1234567890",
    "name": "string",
    "breadcrumbs": [
      {
        "canonical_url": "https://example.com/...",
        "category_id": "1234567890",
        "name": "string"
      }
    ]
  },
  "price": {
    "formatted_current_price": "string",
    "formatted_comparison_price": "string",
    "current_retail_min": 0.0,
    "current_retail_max": 0.0,
    "reg_retail": 0.0,
    "price_type": "string",
    "currency": "USD",
    "on_sale": false
  },
  "rating": {
    "average": 0.0,
    "count": 0,
    "distribution": {},
    "secondary_averages": [
      {}
    ]
  },
  "reviews": {
    "review_count": 0,
    "recommended_count": 0,
    "not_recommended_count": 0,
    "recommended_percentage": 0,
    "guest_reviews_summary": "string",
    "pros": [
      "string"
    ],
    "cons": [
      "string"
    ],
    "overall_sentiment": "string"
  },
  "badges": [
    "string"
  ],
  "description": {
    "headline": "string",
    "bullet_descriptions": [
      "string"
    ],
    "soft_bullets": [
      "string"
    ],
    "downstream_description": "string",
    "downstream_description_html": "string"
  },
  "specifications": {},
  "wellness_attributes": [
    {
      "name": "string",
      "description": "string",
      "badge_url": "https://example.com/..."
    }
  ],
  "images": {
    "primary_image": "string",
    "alternate_images": [
      "string"
    ],
    "all_images": [
      "string"
    ]
  },
  "videos": [
    {
      "video_title": "string",
      "video_url": "https://example.com/...",
      "thumbnail_url": "https://example.com/...",
      "duration": "string",
      "mime_type": "string",
      "captions": [
        "string"
      ]
    }
  ],
  "variants": {
    "children_count": 0,
    "children": [
      {
        "tcin": "string",
        "title": "string",
        "dpci": "string",
        "upc": "string",
        "variation_name": "string",
        "variation_value": "string",
        "formatted_price": "string",
        "current_retail": 0.0,
        "reg_retail": 0.0,
        "primary_image": "string",
        "buy_url": "https://example.com/..."
      }
    ],
    "variation_hierarchy": [
      "string"
    ]
  },
  "protection_plans": [
    {
      "tcin": "string",
      "title": "string",
      "price": "string",
      "bullets": [
        "string"
      ]
    }
  ],
  "promotions": [
    {
      "promotion_id": "1234567890",
      "description": "string",
      "promotion_class": "string",
      "channel": "string",
      "circle_offer": false
    }
  ],
  "shipping_and_returns": {
    "return_policy_message": "string",
    "return_policy_url": "https://example.com/...",
    "cart_add_on_threshold": 0.0,
    "handling": {}
  },
  "availability": {
    "in_stock": false,
    "is_limited_time_offer": false,
    "fast_selling": false
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Target Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
tcin	string	Yes	Target Circle / Item Number identifier.
dpci	string	No	Target DPCI inventory identifier.
upc	string	No	Universal Product Code (UPC) or primary barcode.
title	string	Yes	Full product title without HTML entities or tags.
brand	object	No	Brand details and links.
brand.name	string	No	Brand or manufacturer name.
brand.id	string	No	Target internal brand linking identifier.
brand.canonical_url	string	No	Full URL to brand shop page on Target.
url	string	Yes	Canonical buy URL for the product.
breadcrumbs	array<string>	No	Category navigation breadcrumbs sequence.
category	object	No	Detailed category hierarchy and metadata.
category.parent_category_id	string	No
category.name	string	No
category.breadcrumbs	array<object>	No
category.breadcrumbs[].canonical_url	string	No
category.breadcrumbs[].category_id	string	No
category.breadcrumbs[].name	string	No
price	object	Yes	Comprehensive pricing information.
price.formatted_current_price	string	No	Formatted price string, e.g. '$129.99 - $179.99'.
price.formatted_comparison_price	string	No	Formatted comparison or regular price before sale.
price.current_retail_min	number \| null	No	Minimum current retail price.
price.current_retail_max	number \| null	No	Maximum current retail price across variants.
price.reg_retail	number \| null	No	Regular retail price.
price.price_type	string	No	Pricing status: 'reg' or 'sale'.
price.currency	string	No	Currency code (USD).
price.on_sale	boolean	No	Whether the product is currently discounted.
rating	object	Yes	Customer rating breakdown.
rating.average	number \| null	No	Average review score on a 5.0 scale.
rating.count	integer	No	Total count of ratings submitted.
rating.distribution	object	No	Star distribution count breakdown (rating1 to rating5).
rating.secondary_averages	array<object>	No	Secondary criteria scores (ease of use, value, features, etc.).
reviews	object	Yes	User reviews and AI summarization.
reviews.review_count	integer	No	Total number of written reviews.
reviews.recommended_count	integer	No	Count of reviewers recommending the item.
reviews.not_recommended_count	integer	No	Count of reviewers not recommending the item.
reviews.recommended_percentage	integer	No	Percentage of reviewers who recommend this product.
reviews.guest_reviews_summary	string	No	AI-generated synthesis of guest review sentiments.
reviews.pros	array<string>	No
reviews.cons	array<string>	No
reviews.overall_sentiment	string	No	Aggregated sentiment assessment (e.g. positive, mixed).
badges	array<string>	No	Customer proof and desirability badges (e.g. '13k+ bought in last month', 'Rarely returned').
description	object	No	Product descriptions and bullet points.
description.headline	string	No
description.bullet_descriptions	array<string>	No	Cleaned list of highlight bullets.
description.soft_bullets	array<string>	No	Feature overview blurbs.
description.downstream_description	string	No	Clean plaintext product description.
description.downstream_description_html	string	No	Raw HTML product description.
specifications	object	No	Extracted key-value pairs of technical and physical specifications.
wellness_attributes	array<object>	No
wellness_attributes[].name	string	No
wellness_attributes[].description	string	No
wellness_attributes[].badge_url	string	No
images	object	No	Product imagery.
images.primary_image	string	No	High-resolution primary image URL.
images.alternate_images	array<string>	No	Alternate gallery and angle images.
images.all_images	array<string>	No
videos	array<object>	No	Product demonstration and promotional videos.
videos[].video_title	string	No
videos[].video_url	string	No
videos[].thumbnail_url	string	No
videos[].duration	string	No
videos[].mime_type	string	No
videos[].captions	array<string>	No
variants	object	No	Product variations and children.
variants.children_count	integer	No
variants.children	array<object>	No	Fully detailed child items.
variants.children[].tcin	string	No
variants.children[].title	string	No
variants.children[].dpci	string	No
variants.children[].upc	string	No
variants.children[].variation_name	string	No
variants.children[].variation_value	string	No
variants.children[].formatted_price	string	No
variants.children[].current_retail	number	No
variants.children[].reg_retail	number	No
variants.children[].primary_image	string	No
variants.children[].buy_url	string	No
variants.variation_hierarchy	array	No
protection_plans	array<object>	No	Protection plans and warranty options (e.g. Allstate).
protection_plans[].tcin	string	No
protection_plans[].title	string	No
protection_plans[].price	string	No
protection_plans[].bullets	array<string>	No
promotions	array<object>	No	Active promotional messages and subscription offers.
promotions[].promotion_id	string	No
promotions[].description	string	No
promotions[].promotion_class	string	No
promotions[].channel	string	No
promotions[].circle_offer	boolean	No
shipping_and_returns	object	No	Fulfillment policies and thresholds.
shipping_and_returns.return_policy_message	string	No
shipping_and_returns.return_policy_url	string	No
shipping_and_returns.cart_add_on_threshold	number	No
shipping_and_returns.handling	object	No
availability	object	No	Availability indicators.
availability.in_stock	boolean	No
availability.is_limited_time_offer	boolean	No
availability.fast_selling	boolean	No

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/target/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/costco/products/details

Costco Product Details

POST /api/v1/costco/products/details

Get product details from a Costco.com product URL, including price, ratings, features, specifications and images.

Overview

Get product details from a Costco.com product URL, including price, ratings, features, specifications and images.

POST /api/v1/costco/products/details

Method: POST Path: /api/v1/costco/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code (default US).
product_url	string	Required	Full Costco product URL (e.g. https://www.costco.com/p/-/costco-shop-card/10024438).

Request Example

Costco Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/costco/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "item_number": "string",
  "sku": "string",
  "title": "string",
  "brand": "string",
  "url": "https://example.com/...",
  "description": "string",
  "features": [
    "string"
  ],
  "price": {
    "current_price": 0.0,
    "currency": "USD"
  },
  "rating": {
    "average_rating": 0.0,
    "review_count": 0
  },
  "images": [
    "string"
  ],
  "categories": [
    "string"
  ],
  "specifications": {},
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Costco Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
item_number	string	Yes	Costco item number from the product URL.
sku	string \| null	No	Selected item SKU.
title	string	Yes	Cleaned product display title.
brand	string \| null	No	Brand name.
url	string	Yes	Canonical product URL on Costco.com.
description	string \| null	No	Product description.
features	array<string>	No	Product feature bullet points.
price	object	Yes	Pricing information object.
price.current_price	number \| null	Yes	Current price; null when Costco does not publish it on the product page.
price.currency	string	Yes	ISO currency code.
rating	object	No	Customer rating summary.
rating.average_rating	number \| null	No	Average customer rating out of 5.
rating.review_count	integer \| null	No	Number of customer ratings.
images	array<string>	No	Product image URLs.
categories	array<string>	No	Category breadcrumb names, broadest first.
specifications	object	No	Product specifications as name and value pairs.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/costco/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0032 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/wayfair/products/search

Wayfair Product Search

POST /api/v1/wayfair/products/search

Search Wayfair.com by keyword and get matching products with titles, brands, prices, ratings, review counts, images, and delivery details.

Overview

Search Wayfair.com by keyword and get matching products with titles, brands, prices, ratings, review counts, images, and delivery details.

POST /api/v1/wayfair/products/search

Method: POST Path: /api/v1/wayfair/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 48).
location	string	Optional	Two-letter country code (default US).
query	string	Required	Search keywords, e.g. "blue velvet armchair"

Request Example

Wayfair Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/wayfair/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "total_results": 0,
  "returned_results": 0,
  "matched_category": "string",
  "results": [
    {
      "product_id": "1234567890",
      "title": "string",
      "brand": "string",
      "url": "https://example.com/...",
      "price": {
        "current_price": 0.0,
        "regular_price": 0.0,
        "currency": "USD"
      },
      "rating": {
        "average_rating": 0.0,
        "review_count": 0
      },
      "image": "string",
      "badge": "string",
      "options": "string",
      "shipping": "string",
      "delivery_estimate": "string",
      "stock_message": "string",
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Wayfair Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	Original search keyword or term queried.
total_results	integer	Yes	Estimated total number of matching products on Wayfair.
returned_results	integer	No	Number of product items returned in this response.
matched_category	string \| null	No	Wayfair category the search landed on, when the keywords match a category.
results	array<object>	Yes	List of product cards matching the query.
results[].product_id	string	Yes	Wayfair product identifier, e.g. 'W110562316'.
results[].title	string	Yes	Cleaned product display title.
results[].brand	string \| null	No	Brand name.
results[].url	string	Yes	Full product URL on Wayfair.com.
results[].price	object	Yes	Pricing information object.
results[].price.current_price	number \| null	No	Numeric current price.
results[].price.regular_price	number \| null	No	Numeric price before any discount.
results[].price.currency	string	No	Three-letter currency code (USD).
results[].rating	object	No	Customer rating summary.
results[].rating.average_rating	number \| null	No	Average review score on a 5.0 scale.
results[].rating.review_count	integer \| null	No	Total customer review count.
results[].image	string \| null	No	Primary product image URL.
results[].badge	string \| null	No	Promotional label, e.g. 'Fall Clearance'.
results[].options	string \| null	No	Available options summary, e.g. '17 Colors'.
results[].shipping	string \| null	No	Shipping label, e.g. 'FREE Fast Delivery'.
results[].delivery_estimate	string \| null	No	Estimated delivery date text.
results[].stock_message	string \| null	No	Stock level text, e.g. '604 Left in Stock'.
results[].sponsored	boolean	No	True if the result is a paid placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/wayfair/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,24,US

Pricing & Rate Limits

Endpoint Pricing

$0.0032 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/wayfair/products/details

Wayfair Product Details

POST /api/v1/wayfair/products/details

Get product details from a Wayfair.com product URL, including price, ratings, specifications, dimensions, images and availability.

Overview

Get product details from a Wayfair.com product URL, including price, ratings, specifications, dimensions, images and availability.

POST /api/v1/wayfair/products/details

Method: POST Path: /api/v1/wayfair/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code (default US).
product_url	string	Required	Full Wayfair product URL (e.g. https://www.wayfair.com/furniture/pdp/ebern-designs-oliver-upholstered-sofa-w110562316.html).

Request Example

Wayfair Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/wayfair/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "product_id": "1234567890",
  "title": "string",
  "brand": "string",
  "collection": "string",
  "url": "https://example.com/...",
  "part_number": "string",
  "description": "string",
  "features": [
    "string"
  ],
  "price": {
    "current_price": 0.0,
    "regular_price": 0.0,
    "discount": "string",
    "currency": "USD"
  },
  "rating": {
    "average_rating": 0.0,
    "review_count": 0
  },
  "availability": {
    "in_stock": false,
    "status": "string",
    "message": "string",
    "delivery": "string",
    "delivery_estimate": "string"
  },
  "selected_options": [
    "string"
  ],
  "images": [
    "string"
  ],
  "categories": [
    "string"
  ],
  "dimensions": {},
  "specifications": {},
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Wayfair Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
product_id	string	Yes	Wayfair product identifier from the product URL.
title	string	Yes	Cleaned product display title.
brand	string \| null	No	Brand name.
collection	string \| null	No	Brand collection the product belongs to.
url	string	Yes	Product URL on Wayfair.com.
part_number	string \| null	No	Manufacturer part number, when published.
description	string \| null	No	Product description.
features	array<string>	No	Product feature bullet points.
price	object	Yes	Pricing information object.
price.current_price	number \| null	Yes	Numeric current price.
price.regular_price	number \| null	No	Numeric price before any discount.
price.discount	string \| null	No	Discount label, e.g. '37% Off'.
price.currency	string	Yes	Three-letter currency code (USD).
rating	object	No	Customer rating summary.
rating.average_rating	number \| null	No	Average review score on a 5.0 scale.
rating.review_count	integer \| null	No	Total customer review count.
availability	object	No	Stock and delivery information.
availability.in_stock	boolean \| null	No	Item in-stock availability flag.
availability.status	string \| null	No	Stock status code, e.g. 'IN_STOCK'.
availability.message	string \| null	No	Stock level text, e.g. '604 Left in Stock'.
availability.delivery	string \| null	No	Delivery offer text, e.g. 'FREE 3-Day Delivery'.
availability.delivery_estimate	string \| null	No	Estimated delivery date text.
selected_options	array<string>	No	Options selected for this product, e.g. color or material.
images	array<string>	No	Product image URLs. The first images are full size; later ones may be smaller.
categories	array<string>	No	Category breadcrumb names.
dimensions	object	No	Key-value dictionary of product dimensions and weight.
specifications	object	No	Specifications grouped by section (details, assembly, warranty, certifications).

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/wayfair/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0032 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/aliexpress/products/search

AliExpress Product Search

POST /api/v1/aliexpress/products/search

Search AliExpress by keyword and get matching products with titles, prices, discounts, ratings, units sold, images, and shipping details.

Overview

Search AliExpress by keyword and get matching products with titles, prices, discounts, ratings, units sold, images, and shipping details.

POST /api/v1/aliexpress/products/search

Method: POST Path: /api/v1/aliexpress/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 60).
location	string	Optional	Two-letter country code (default US). Prices and currency follow this country.
query	string	Required	Search keywords, e.g. "bluetooth headphones"

Request Example

AliExpress Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/aliexpress/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "total_results": 0,
  "returned_results": 0,
  "related_searches": [
    "string"
  ],
  "results": [
    {
      "product_id": "1234567890",
      "title": "string",
      "url": "https://example.com/...",
      "price": {
        "current_price": 0.0,
        "formatted_price": "string",
        "discount_percent": 0.0,
        "currency": "USD"
      },
      "rating": {
        "average_rating": 0.0
      },
      "units_sold": "string",
      "image": "string",
      "images": [
        "string"
      ],
      "free_shipping": false,
      "delivery_estimate": "string",
      "attributes": [
        "string"
      ],
      "badges": [
        "string"
      ],
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "AliExpress Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	The search keyword or term queried.
total_results	integer	Yes	Total number of matching products reported by AliExpress.
returned_results	integer	Yes	Number of product items returned in this response.
related_searches	array<string>	No	Related search terms suggested by AliExpress.
results	array<object>	Yes	List of priced products matching the query.
results[].product_id	string	Yes	AliExpress product identifier.
results[].title	string	Yes	Product display name.
results[].url	string	Yes	Full product URL on AliExpress.
results[].price	object	Yes	Lowest price shown to a new visitor, which can include first-order and sale discounts.
results[].price.current_price	number	Yes	Current lowest selling price.
results[].price.formatted_price	string \| null	No	Price as displayed, including its currency symbol.
results[].price.discount_percent	number \| null	No	Discount off the regular price, in percent.
results[].price.currency	string \| null	Yes	ISO currency code of the price.
results[].rating	object	No	Customer rating summary.
results[].rating.average_rating	number \| null	No	Average rating score out of 5.0.
results[].units_sold	string \| null	No	Units sold as displayed, e.g. "1K+ sold".
results[].image	string \| null	No	Main product image URL.
results[].images	array<string>	No	Product image URLs.
results[].free_shipping	boolean	No	Whether the listing advertises free shipping.
results[].delivery_estimate	string \| null	No	Delivery estimate as displayed, e.g. "Fastest delivery in 5 days".
results[].attributes	array<string>	No	Key product attributes shown on the listing.
results[].badges	array<string>	No	Promotional and status labels (e.g. Lowest price in 90 days, Top selling on AliExpress).
results[].sponsored	boolean	No	Whether the listing is a paid placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/aliexpress/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,24,US

Pricing & Rate Limits

Endpoint Pricing

$0.0018 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/alibaba/products/search

Alibaba Product Search

POST /api/v1/alibaba/products/search

Search Alibaba by keyword and get matching wholesale products with titles, price ranges, minimum order quantities, images, and supplier details.

Overview

Search Alibaba by keyword and get matching wholesale products with titles, price ranges, minimum order quantities, images, and supplier details.

POST /api/v1/alibaba/products/search

Method: POST Path: /api/v1/alibaba/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 40).
location	string	Optional	Two-letter country code (default US). Prices and currency follow this country.
query	string	Required	Search keywords in English, e.g. "wireless headphones"

Request Example

Alibaba Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/alibaba/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "total_results": 0,
  "returned_results": 0,
  "results": [
    {
      "product_id": "1234567890",
      "title": "string",
      "url": "https://example.com/...",
      "price": {
        "min_price": 0.0,
        "max_price": 0.0,
        "formatted_price": "string",
        "currency": "USD"
      },
      "min_order": "string",
      "image": "string",
      "images": [
        "string"
      ],
      "supplier": {
        "name": "string",
        "url": "https://example.com/...",
        "country": "string",
        "years_on_platform": "string",
        "average_rating": 0.0,
        "review_count": 0
      },
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Alibaba Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	The search keyword or term queried.
total_results	integer	Yes	Total number of matching products reported by Alibaba.
returned_results	integer	Yes	Number of product items returned in this response.
results	array<object>	Yes	List of products matching the query.
results[].product_id	string	Yes	Alibaba product identifier.
results[].title	string	Yes	Product display name.
results[].url	string	Yes	Full product URL on Alibaba.
results[].price	object	Yes	Wholesale price or price range, which usually depends on the order quantity.
results[].price.min_price	number \| null	Yes	Lowest listed unit price.
results[].price.max_price	number \| null	Yes	Highest listed unit price.
results[].price.formatted_price	string \| null	No	Price as displayed, including its currency symbol, e.g. "$5.20-8".
results[].price.currency	string \| null	Yes	ISO currency code, or null when the displayed symbol doesn't identify one.
results[].min_order	string \| null	No	Minimum order quantity as displayed, e.g. "3 pieces".
results[].image	string \| null	No	Main product image URL.
results[].images	array<string>	No	Product image URLs.
results[].supplier	object	No	The company selling this product.
results[].supplier.name	string \| null	No	Company name.
results[].supplier.url	string \| null	No	Company profile URL on Alibaba.
results[].supplier.country	string \| null	No	Two-letter country code of the company.
results[].supplier.years_on_platform	string \| null	No	Time on Alibaba as displayed, e.g. "3 yrs".
results[].supplier.average_rating	number \| null	No	The supplier's average rating out of 5.0, across its products.
results[].supplier.review_count	integer	No	Number of reviews behind the supplier's rating.
results[].sponsored	boolean	No	Whether the listing is a paid placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/alibaba/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,24,US

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/alibaba/products/details

Alibaba Product Details

POST /api/v1/alibaba/products/details

Get product details from an Alibaba product URL, including quantity-based prices, minimum order, specifications, purchase options, images and supplier information.

Overview

Get product details from an Alibaba product URL, including quantity-based prices, minimum order, specifications, purchase options, images and supplier information.

POST /api/v1/alibaba/products/details

Method: POST Path: /api/v1/alibaba/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code (default US). Prices and currency follow this country.
product_url	string	Required	Full Alibaba product URL (e.g. https://www.alibaba.com/product-detail/Wireless-Headphones_1601749124707.html).

Request Example

Alibaba Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/alibaba/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "product_id": "1234567890",
  "title": "string",
  "url": "https://example.com/...",
  "brand": "string",
  "price": {
    "min_price": 0.0,
    "max_price": 0.0,
    "formatted_price": "string",
    "currency": "USD",
    "unit": "string",
    "tiers": [
      {
        "min_quantity": 0,
        "max_quantity": 0,
        "price": 0.0,
        "formatted_price": "string"
      }
    ]
  },
  "min_order": "string",
  "rating": {
    "average_rating": 0.0,
    "review_count": 0
  },
  "images": [
    "string"
  ],
  "videos": [
    "string"
  ],
  "options": {},
  "specifications": {},
  "categories": [
    "string"
  ],
  "ships_from": "string",
  "supplier": {
    "name": "string",
    "url": "https://example.com/...",
    "country": "string",
    "business_type": "string",
    "years_on_platform": "string",
    "employees": "string",
    "response_time": "string",
    "on_time_delivery_rate": "string",
    "average_rating": 0.0,
    "review_count": 0
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Alibaba Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
product_id	string	Yes	Alibaba product identifier.
title	string	Yes	Product display name.
url	string	Yes	Full product URL on Alibaba.
brand	string \| null	No	Brand name, when the supplier lists one.
price	object	Yes	Wholesale price, which usually depends on the order quantity.
price.min_price	number \| null	Yes	Lowest listed unit price.
price.max_price	number \| null	Yes	Highest listed unit price.
price.formatted_price	string \| null	No	Price as displayed, including its currency symbol, e.g. "$5.20-8".
price.currency	string \| null	Yes	ISO currency code, or null when the displayed symbol doesn't identify one.
price.unit	string \| null	No	Unit the price applies to, e.g. "piece".
price.tiers	array<object>	No	Unit price by order quantity.
price.tiers[].min_quantity	integer \| null	No	Smallest quantity for this price.
price.tiers[].max_quantity	integer \| null	No	Largest quantity for this price, or null when there is no upper limit.
price.tiers[].price	number \| null	No	Unit price at this quantity.
price.tiers[].formatted_price	string \| null	No	Unit price as displayed.
min_order	string \| null	No	Minimum order quantity, e.g. "1 piece".
rating	object	No	Reviews of this product. Empty for products without their own reviews.
rating.average_rating	number \| null	No	Average rating score out of 5.0.
rating.review_count	integer	No	Number of product reviews.
images	array<string>	No	Full-size product image URLs.
videos	array<string>	No	Product video URLs.
options	object	No	Purchase options and their values, e.g. color: Black, Silver.
specifications	object	No	Product attributes as listed by the supplier.
categories	array<string>	No	Category path, from broadest to narrowest.
ships_from	string \| null	No	Two-letter country code the product ships from.
supplier	object	Yes	The company selling this product.
supplier.name	string \| null	No	Company name.
supplier.url	string \| null	No	Company profile URL on Alibaba.
supplier.country	string \| null	No	Two-letter country code of the company.
supplier.business_type	string \| null	No	Business type, e.g. "Trading Company".
supplier.years_on_platform	string \| null	No	Time on Alibaba as displayed, e.g. "3 yrs".
supplier.employees	string \| null	No	Employee count range, e.g. "101-200".
supplier.response_time	string \| null	No	Typical response time as displayed, e.g. "≤1h".
supplier.on_time_delivery_rate	string \| null	No	On-time delivery rate as displayed, e.g. "100.0%".
supplier.average_rating	number \| null	No	The supplier's average rating out of 5.0.
supplier.review_count	integer	No	Number of reviews behind the supplier's rating.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/alibaba/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/lazada/products/search

Lazada Product Search

POST /api/v1/lazada/products/search

Search Lazada in Singapore, Malaysia, the Philippines, Thailand, Vietnam or Indonesia by keyword and get matching products with titles, prices, discounts, ratings, units sold, images and sellers.

Overview

Search Lazada in Singapore, Malaysia, the Philippines, Thailand, Vietnam or Indonesia by keyword and get matching products with titles, prices, discounts, ratings, units sold, images and sellers.

POST /api/v1/lazada/products/search

Method: POST Path: /api/v1/lazada/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 40).
location	string	Optional	Two-letter code of the Lazada country site to search (SG, MY, PH, TH, VN or ID; default SG). Prices are in that country's currency.
query	string	Required	Search keywords, e.g. "xiaomi band"

Request Example

Lazada Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/lazada/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "location": "SG", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "location": "string",
  "total_results": 0,
  "returned_results": 0,
  "results": [
    {
      "product_id": "1234567890",
      "sku_id": "1234567890",
      "title": "string",
      "url": "https://example.com/...",
      "brand": "string",
      "price": {
        "current_price": 0.0,
        "original_price": 0.0,
        "formatted_price": "string",
        "formatted_original_price": "string",
        "discount": "string",
        "currency": "USD"
      },
      "rating": 0.0,
      "review_count": 0,
      "sold": "string",
      "image": "string",
      "seller": {
        "name": "string",
        "id": "1234567890"
      },
      "ships_from": "string",
      "in_stock": false,
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Lazada Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	The search keyword or term queried.
location	string	Yes	Country site that was searched (SG, MY, PH, TH, VN or ID).
total_results	integer	Yes	Number of matching products reported by Lazada (the site caps this count for broad searches).
returned_results	integer	Yes	Number of product items returned in this response.
results	array<object>	Yes	List of products matching the query.
results[].product_id	string	Yes	Lazada item identifier.
results[].sku_id	string \| null	No	Identifier of the product option shown in the listing.
results[].title	string	Yes	Product display name.
results[].url	string	Yes	Full product URL on Lazada.
results[].brand	string \| null	No	Brand name.
results[].price	object	Yes	Current price, with the price before discount when there is one.
results[].price.current_price	number \| null	Yes	Current selling price.
results[].price.original_price	number \| null	No	Price before discount, or null when not discounted.
results[].price.formatted_price	string \| null	No	Current price as displayed, e.g. "$423.00".
results[].price.formatted_original_price	string \| null	No	Price before discount as displayed.
results[].price.discount	string \| null	No	Discount as displayed, e.g. "35% Off".
results[].price.currency	string	Yes	ISO currency code of the country site, e.g. "SGD".
results[].rating	number \| null	No	Average rating out of 5, or null when there are no reviews.
results[].review_count	integer	No	Number of ratings.
results[].sold	string \| null	No	Units sold as displayed, e.g. "93 sold".
results[].image	string \| null	No	Main product image URL.
results[].seller	object	No	The store selling this product.
results[].seller.name	string \| null	No	Store name.
results[].seller.id	string \| null	No	Lazada seller identifier.
results[].ships_from	string \| null	No	Where the product ships from, e.g. "Singapore" or "Overseas".
results[].in_stock	boolean	No	Whether the product can currently be bought.
results[].sponsored	boolean	No	Whether the listing is a paid placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/lazada/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,24,SG

Pricing & Rate Limits

Endpoint Pricing

$0.0032 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/lazada/products/details

Lazada Product Details

POST /api/v1/lazada/products/details

Get product details from a Lazada product URL, including price, discount, ratings, purchase options, specifications, images, seller and delivery information.

Overview

Get product details from a Lazada product URL, including price, discount, ratings, purchase options, specifications, images, seller and delivery information.

POST /api/v1/lazada/products/details

Method: POST Path: /api/v1/lazada/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
product_url	string	Required	Full Lazada product URL from any Lazada country site (e.g. https://www.lazada.sg/products/pdp-i3325102351.html).

Request Example

Lazada Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/lazada/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "product_id": "1234567890",
  "sku_id": "1234567890",
  "title": "string",
  "url": "https://example.com/...",
  "brand": "string",
  "price": {
    "current_price": 0.0,
    "original_price": 0.0,
    "formatted_price": "string",
    "formatted_original_price": "string",
    "discount": "string",
    "currency": "USD"
  },
  "in_stock": false,
  "rating": {
    "average_rating": 0.0,
    "review_count": 0,
    "star_counts": [
      0
    ]
  },
  "sold": "string",
  "images": [
    "string"
  ],
  "options": {},
  "variants": [
    {
      "sku_id": "1234567890",
      "options": {},
      "price": {
        "current_price": 0.0,
        "original_price": 0.0,
        "formatted_price": "string",
        "formatted_original_price": "string",
        "discount": "string",
        "currency": "USD"
      },
      "image": "string",
      "in_stock": false,
      "url": "https://example.com/..."
    }
  ],
  "highlights": [
    "string"
  ],
  "description": "string",
  "specifications": {},
  "box_contents": "string",
  "categories": [
    "string"
  ],
  "seller": {
    "name": "string",
    "id": "1234567890",
    "url": "https://example.com/...",
    "positive_rating": "string",
    "highlights": [
      "string"
    ]
  },
  "ships_from": "string",
  "delivery": {
    "option": "string",
    "estimate": "string"
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Lazada Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
product_id	string	Yes	Lazada item identifier.
sku_id	string \| null	No	Identifier of the selected product option.
title	string	Yes	Product display name.
url	string	Yes	Canonical product URL on Lazada.
brand	string \| null	No	Brand name.
price	object	Yes	Price of the selected option, or the price shown in search listings when the option's own price isn't shown.
price.current_price	number \| null	Yes	Current selling price.
price.original_price	number \| null	No	Price before discount, or null when not discounted.
price.formatted_price	string \| null	No	Current price as displayed, e.g. "$423.00".
price.formatted_original_price	string \| null	No	Price before discount as displayed.
price.discount	string \| null	No	Discount as displayed, e.g. "-35%".
price.currency	string	Yes	ISO currency code of the country site, e.g. "SGD".
in_stock	boolean \| null	No	Whether the selected option can currently be bought.
rating	object	No
rating.average_rating	number \| null	No	Average rating out of 5, or null when there are no reviews.
rating.review_count	integer	No	Number of ratings.
rating.star_counts	array<integer>	No	Number of 5, 4, 3, 2 and 1 star ratings, in that order (empty when not shown).
sold	string \| null	No	Units sold as displayed, e.g. "93 sold".
images	array<string>	No	Product image URLs.
options	object	No	Purchase options by name, e.g. {"Color Family": ["Black", "Sky Teal"]}.
variants	array<object>	No	Each purchasable combination of options.
variants[].sku_id	string	No	Option identifier.
variants[].options	object	No	Selected value for each option name.
variants[].price	object	No	Current price, with the price before discount when there is one.
variants[].price.current_price	number \| null	Yes	Current selling price.
variants[].price.original_price	number \| null	No	Price before discount, or null when not discounted.
variants[].price.formatted_price	string \| null	No	Current price as displayed, e.g. "$423.00".
variants[].price.formatted_original_price	string \| null	No	Price before discount as displayed.
variants[].price.discount	string \| null	No	Discount as displayed, e.g. "-35%".
variants[].price.currency	string	Yes	ISO currency code of the country site, e.g. "SGD".
variants[].image	string \| null	No	Image of this option.
variants[].in_stock	boolean \| null	No	Whether this option can currently be bought.
variants[].url	string \| null	No	Product URL with this option selected.
highlights	array<string>	No	Product highlights, one entry per line.
description	string \| null	No	Product description text.
specifications	object	No	Specification name to value.
box_contents	string \| null	No	What's in the box.
categories	array<string>	No	Category path, from the top-level category down.
seller	object	No	The store selling this product.
seller.name	string \| null	No	Store name.
seller.id	string \| null	No	Lazada seller identifier.
seller.url	string \| null	No	Store page URL.
seller.positive_rating	string \| null	No	Share of positive seller ratings, e.g. "97%".
seller.highlights	array<string>	No	Store badges, e.g. "Fast Shipping: 98% Shipped in 48 hrs".
ships_from	string \| null	No	Where the product ships from, e.g. "Singapore" or "Overseas".
delivery	object	No	Standard delivery to the site's default location.
delivery.option	string \| null	No	Delivery option and fee as displayed.
delivery.estimate	string \| null	No	Estimated delivery date as displayed.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/lazada/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0032 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/flipkart/products/search

Flipkart Product Search

POST /api/v1/flipkart/products/search

Search Flipkart (India) by keyword and get matching products with titles, prices in INR, discounts, ratings, key specifications, images and badges.

Overview

Search Flipkart (India) by keyword and get matching products with titles, prices in INR, discounts, ratings, key specifications, images and badges.

POST /api/v1/flipkart/products/search

Method: POST Path: /api/v1/flipkart/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 40).
query	string	Required	Search keywords, e.g. "iphone"

Request Example

Flipkart Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/flipkart/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "total_results": 0,
  "returned_results": 0,
  "results": [
    {
      "product_id": "1234567890",
      "listing_id": "1234567890",
      "title": "string",
      "subtitle": "string",
      "brand": "string",
      "url": "https://example.com/...",
      "price": {
        "current_price": 0.0,
        "original_price": 0.0,
        "discount_percent": 0.0,
        "currency": "USD"
      },
      "rating": 0.0,
      "rating_count": 0,
      "review_count": 0,
      "image": "string",
      "key_specs": [
        "string"
      ],
      "category": "string",
      "in_stock": false,
      "flipkart_assured": false,
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Flipkart Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	The search keyword or term queried.
total_results	integer	Yes	Number of matching products reported by Flipkart.
returned_results	integer	Yes	Number of product items returned in this response.
results	array<object>	Yes	List of products matching the query, in Flipkart's ranking order.
results[].product_id	string	Yes	Flipkart product identifier (the pid in product URLs).
results[].listing_id	string \| null	No	Identifier of the seller listing shown for the product.
results[].title	string	Yes	Product display name.
results[].subtitle	string \| null	No	Variant summary shown under the title, e.g. "Black, 2.1 Channel".
results[].brand	string \| null	No	Brand name, when shown separately from the title.
results[].url	string	Yes	Full product URL on Flipkart.
results[].price	object	Yes	Current price in Indian rupees, with the list price (MRP) when discounted.
results[].price.current_price	number \| null	Yes	Current selling price.
results[].price.original_price	number \| null	No	List price (MRP) before discount, or null when not discounted.
results[].price.discount_percent	number \| null	No	Discount off the list price in percent, e.g. 65.
results[].price.currency	string	Yes	ISO currency code, always "INR".
results[].rating	number \| null	No	Average rating out of 5, or null when there are no ratings.
results[].rating_count	integer	No	Number of ratings.
results[].review_count	integer	No	Number of written reviews.
results[].image	string \| null	No	Main product image URL.
results[].key_specs	array<string>	No	Key specifications shown in the listing, e.g. "256 GB ROM".
results[].category	string \| null	No	Product category, e.g. "Handset".
results[].in_stock	boolean	No	Whether the product can currently be bought.
results[].flipkart_assured	boolean	No	Whether the listing carries the Flipkart Assured badge.
results[].sponsored	boolean	No	Whether the listing is a paid placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/flipkart/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit
example,24

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/flipkart/products/details

Flipkart Product Details

POST /api/v1/flipkart/products/details

Get product details from a Flipkart product URL, including price and MRP, ratings with breakdown, specifications, images, seller, delivery and featured reviews.

Overview

Get product details from a Flipkart product URL, including price and MRP, ratings with breakdown, specifications, images, seller, delivery and featured reviews.

POST /api/v1/flipkart/products/details

Method: POST Path: /api/v1/flipkart/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
product_url	string	Required	Full Flipkart product URL (e.g. https://www.flipkart.com/apple-iphone-17-black-256-gb/p/itmc61b40459dd98?pid=MOBHQV9YCUG4ZQZK).

Request Example

Flipkart Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/flipkart/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "product_id": "1234567890",
  "listing_id": "1234567890",
  "title": "string",
  "brand": "string",
  "url": "https://example.com/...",
  "category": "string",
  "price": {
    "current_price": 0.0,
    "original_price": 0.0,
    "discount_percent": 0.0,
    "currency": "USD"
  },
  "rating": {
    "average": 0.0,
    "rating_count": 0,
    "review_count": 0,
    "distribution": {},
    "aspects": {}
  },
  "images": [
    "string"
  ],
  "selected_options": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "specifications": [
    {
      "section": "string",
      "specs": {}
    }
  ],
  "availability": {
    "in_stock": false,
    "status": "string"
  },
  "seller": {
    "name": "string",
    "rating": 0.0,
    "id": "1234567890"
  },
  "delivery": {
    "min_days": 0,
    "max_days": 0,
    "cash_on_delivery": false
  },
  "return_policy": "string",
  "top_reviews": [
    {
      "title": "string",
      "rating": 0.0,
      "author": "string",
      "date": "2026-01-01T12:00:00Z",
      "text": "string"
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Flipkart Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
product_id	string	Yes	Flipkart product identifier (the pid in product URLs).
listing_id	string \| null	No	Identifier of the seller listing shown on the page.
title	string	Yes	Product display name.
brand	string \| null	No	Brand name.
url	string	Yes	Product page URL without tracking parameters.
category	string \| null	No	Product category, e.g. "mobile".
price	object	Yes	Current price in Indian rupees, with the list price (MRP) when discounted.
price.current_price	number \| null	Yes	Current selling price.
price.original_price	number \| null	No	List price (MRP) before discount, or null when not discounted.
price.discount_percent	number \| null	No	Discount off the list price in percent.
price.currency	string	Yes	ISO currency code, e.g. "INR".
rating	object	No	Customer rating summary.
rating.average	number \| null	No	Average rating out of 5, or null when there are no ratings.
rating.rating_count	integer	No	Number of ratings.
rating.review_count	integer	No	Number of written reviews.
rating.distribution	object	No	Number of ratings per star value, keyed "1" to "5".
rating.aspects	object	No	Average rating per product aspect, e.g. {"Camera": 4.7, "Battery": 4.3}.
images	array<string>	No	Product image URLs.
selected_options	array<object>	No	Variant options of this product, e.g. color and storage.
selected_options[].name	string	No	Option name, e.g. "color".
selected_options[].value	string	No	Option value, e.g. "Black".
specifications	array<object>	No	Specification groups as listed on the product page.
specifications[].section	string	Yes	Group name, e.g. "General" or "Display Features".
specifications[].specs	object	Yes	Specification name to value, e.g. {"Model Number": "MG6J4HN/A"}.
availability	object	No	Stock status.
availability.in_stock	boolean	No	Whether the product can currently be bought.
availability.status	string \| null	No	Availability status reported by Flipkart, e.g. "IN_STOCK".
seller	object	No	The seller of the listing shown on the page.
seller.name	string \| null	No	Seller name.
seller.rating	number \| null	No	Seller rating out of 5.
seller.id	string \| null	No	Flipkart seller identifier.
delivery	object	No	Standard delivery estimate.
delivery.min_days	integer \| null	No	Minimum delivery time in days.
delivery.max_days	integer \| null	No	Maximum delivery time in days.
delivery.cash_on_delivery	boolean \| null	No	Whether cash on delivery is available.
return_policy	string \| null	No	Return or replacement policy, when stated.
top_reviews	array<object>	No	Featured customer reviews shown on the product page.
top_reviews[].title	string \| null	No	Review headline.
top_reviews[].rating	number \| null	No	Star rating given by the reviewer.
top_reviews[].author	string \| null	No	Reviewer name.
top_reviews[].date	string \| null	No	Publication date (YYYY-MM-DD).
top_reviews[].text	string \| null	No	Review text.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/flipkart/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/1688/products/search

1688 Product Search

POST /api/v1/1688/products/search

Search 1688.com wholesale offers by keyword and get products with wholesale prices, MOQ, transaction volumes, repeat purchase rates, seller locations, and trust badges.

Overview

Search 1688.com wholesale offers by keyword and get products with wholesale prices, MOQ, transaction volumes, repeat purchase rates, seller locations, and trust badges.

POST /api/v1/1688/products/search

Method: POST Path: /api/v1/1688/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return.
location	string	Optional	Two-letter country code for proxy routing (default CN).
page	integer	Optional	Page number for pagination.
query	string	Required	Search keywords, e.g. "手机壳" or "t shirt"

Request Example

1688 Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/1688/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "20", "location": "CN", "page": "1", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "1688 Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/1688/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location,page
example,20,CN,1

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/1688/products/details

1688 Product Details

POST /api/v1/1688/products/details

Get maximum detailed wholesale product data from a 1688.com offer URL including tiered wholesale price ladders, MOQ, full specifications, SKU variation matrix, supplier profile, and high-res media gallery.

Overview

POST /api/v1/1688/products/details

Method: POST Path: /api/v1/1688/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code for proxy routing (default CN).
product_url	string	Required	Full 1688 offer URL (e.g. https://detail.1688.com/offer/896192389922.html).

Request Example

1688 Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/1688/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "CN", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "1688 Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/1688/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,CN

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/homedepot/products/search

Home Depot Product Search

POST /api/v1/homedepot/products/search

Search HomeDepot.com by keyword and get matching products with prices, ratings, review counts, images, inventory, and badges.

Overview

Search HomeDepot.com by keyword and get matching products with prices, ratings, review counts, images, inventory, and badges.

POST /api/v1/homedepot/products/search

Method: POST Path: /api/v1/homedepot/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return.
location	string	Optional	Two-letter country code (default US).
query	string	Required	Search keywords, e.g. "dewalt drill"

Request Example

Home Depot Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/homedepot/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Home Depot Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/homedepot/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,24,US

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/homedepot/products/details

Home Depot Product Details

POST /api/v1/homedepot/products/details

Get maximum detailed product data from a HomeDepot.com product URL using deep Apollo state and schema parsing.

Overview

Get maximum detailed product data from a HomeDepot.com product URL using deep Apollo state and schema parsing.

POST /api/v1/homedepot/products/details

Method: POST Path: /api/v1/homedepot/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code (default US).
product_url	string	Required	Full Home Depot product URL (e.g. https://www.homedepot.com/p/.../322138483).

Request Example

Home Depot Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/homedepot/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Home Depot Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/homedepot/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/shopee/products/search

Shopee Product Search

POST /api/v1/shopee/products/search

Search Shopee products by keyword across Southeast Asia and global regional markets (Singapore, Malaysia, Philippines, etc.) and get items with titles, prices, ratings, discount rates, seller locations, and high-resolution images.

Overview

POST /api/v1/shopee/products/search

Method: POST Path: /api/v1/shopee/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return.
page	integer	Optional	Page number for pagination.
query	string	Required	Search keywords, e.g. "wireless earbuds" or "mechanical keyboard"
region	string	Optional	Two-letter country/region code (SG, MY, PH, ID, VN, TH, TW, BR).

Request Example

Shopee Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/shopee/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "20", "page": "1", "query": "example", "region": "SG"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Shopee Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/shopee/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,page,region
example,20,1,SG

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/shopee/products/details

Shopee Product Details

POST /api/v1/shopee/products/details

Get maximum detailed product data from a Shopee product URL including full specifications, pricing, ratings, high-res images, seller location, promotional badges, and parsed features.

Overview

Get maximum detailed product data from a Shopee product URL including full specifications, pricing, ratings, high-res images, seller location, promotional badges, and parsed features.

POST /api/v1/shopee/products/details

Method: POST Path: /api/v1/shopee/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
product_url	string	Required	Full Shopee product URL (e.g. https://shopee.sg/product-name-i.12345678.9876543210).
region	string	Optional	Two-letter country/region code (default SG).

Request Example

Shopee Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/shopee/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url": "example", "region": "SG"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "...": "Fields returned by the data source",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Shopee Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/shopee/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,region
example,SG

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/mercadolibre/products/search

Mercado Libre Product Search

POST /api/v1/mercadolibre/products/search

Search Mercado Libre by keyword in a Latin American country and get matching listings with titles, prices in local currency, discounts, installments, ratings, sellers, shipping and images.

Overview

Search Mercado Libre by keyword in a Latin American country and get matching listings with titles, prices in local currency, discounts, installments, ratings, sellers, shipping and images.

POST /api/v1/mercadolibre/products/search

Method: POST Path: /api/v1/mercadolibre/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 50).
location	string	Optional	Two-letter code of the Mercado Libre country site to search (default AR). One of AR, MX, BR, CO, CL, PE, UY, EC.
query	string	Required	Search keywords, e.g. "iphone"

Request Example

Mercado Libre Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/mercadolibre/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "24", "location": "AR", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "country": "string",
  "site": "string",
  "total_results": 0,
  "returned_results": 0,
  "results": [
    {
      "item_id": "1234567890",
      "product_id": "1234567890",
      "title": "string",
      "url": "https://example.com/...",
      "price": {
        "current_price": 0.0,
        "original_price": 0.0,
        "discount_percent": 0.0,
        "currency": "USD",
        "installments": "string"
      },
      "rating": 0.0,
      "seller": "string",
      "official_store": false,
      "image": "string",
      "shipping": "string",
      "promotions": [
        "string"
      ],
      "sold_quantity": 0,
      "category_id": "1234567890",
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Mercado Libre Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	Original search keyword or term queried.
country	string	Yes	Two-letter code of the Mercado Libre country site searched, e.g. 'AR'.
site	string	No	Domain of the Mercado Libre country site, e.g. 'mercadolibre.com.ar'.
total_results	integer	Yes	Estimated total number of matching listings on Mercado Libre.
returned_results	integer	Yes	Number of listings parsed and returned in this response.
results	array<object>	Yes	List of listings matching the query.
results[].item_id	string	Yes	Mercado Libre listing identifier, e.g. 'MLA2396564888'.
results[].product_id	string \| null	No	Catalog product identifier when the listing belongs to a catalog product.
results[].title	string	Yes	Listing title.
results[].url	string \| null	Yes	Full product page URL.
results[].price	object	Yes	Pricing information object.
results[].price.current_price	number \| null	No	Current selling price in local currency.
results[].price.original_price	number \| null	No	Price before discount, if the listing is discounted.
results[].price.discount_percent	number \| null	No	Discount percentage off the original price.
results[].price.currency	string	No	Three-letter currency code, e.g. 'ARS', 'MXN', 'BRL'.
results[].price.installments	string \| null	No	Installment offer text, e.g. 'Mismo precio 12 cuotas de $ 191,666'.
results[].rating	number \| null	No	Average review score on a 5.0 scale.
results[].seller	string \| null	No	Seller or official store name shown on the listing.
results[].official_store	boolean	No	True if the listing is sold by an official store.
results[].image	string \| null	No	Primary listing image URL.
results[].shipping	string \| null	No	Shipping and delivery text, e.g. 'Llega gratis mañana'.
results[].promotions	array<string>	No	Promotion texts such as coupons.
results[].sold_quantity	integer \| null	No	Approximate number of units sold, when shown.
results[].category_id	string \| null	No	Mercado Libre category identifier.
results[].sponsored	boolean	No	True if the listing is a sponsored placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/mercadolibre/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,24,AR

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/mercadolibre/products/details

Mercado Libre Product Details

POST /api/v1/mercadolibre/products/details

Get product details from a Mercado Libre product URL, including price and discount, installments, ratings, seller reputation, stock, specifications, variations, images and description.

Overview

Get product details from a Mercado Libre product URL, including price and discount, installments, ratings, seller reputation, stock, specifications, variations, images and description.

POST /api/v1/mercadolibre/products/details

Method: POST Path: /api/v1/mercadolibre/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
product_url	string	Required	Full Mercado Libre product URL from any supported country site (e.g. https://www.mercadolibre.com.ar/apple-iphone-17-256-gb-lavanda-distribuidor-autorizado/p/MLA1055308835).

Request Example

Mercado Libre Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/mercadolibre/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "item_id": "1234567890",
  "catalog_product_id": "1234567890",
  "title": "string",
  "condition_and_sales": "string",
  "url": "https://example.com/...",
  "country": "string",
  "site": "string",
  "price": {
    "current_price": 0.0,
    "original_price": 0.0,
    "discount_percent": 0.0,
    "currency": "USD",
    "installments": "string"
  },
  "rating": 0.0,
  "review_count": 0,
  "brand": "string",
  "sku": "string",
  "gtin": "string",
  "in_stock": false,
  "available_quantity": "string",
  "free_shipping": false,
  "fulfillment": "string",
  "seller": {
    "name": "string",
    "id": "1234567890",
    "official_store": false,
    "reputation_level": "string",
    "power_seller_status": "string"
  },
  "images": [
    "string"
  ],
  "description": "string",
  "specifications": {},
  "variations": [
    {
      "name": "string",
      "selected": "string",
      "options": [
        "string"
      ]
    }
  ],
  "breadcrumbs": [
    "string"
  ],
  "category_id": "1234567890",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Mercado Libre Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
item_id	string \| null	No	Mercado Libre listing identifier, e.g. 'MLA2622317986'.
catalog_product_id	string \| null	No	Catalog product identifier, e.g. 'MLA1055308835'.
title	string	Yes	Product title.
condition_and_sales	string \| null	No	Condition and sales summary, e.g. 'Nuevo \| +1000 vendidos'.
url	string	Yes	Canonical product page URL.
country	string	Yes	Two-letter code of the Mercado Libre country site, e.g. 'AR'.
site	string	No	Domain of the Mercado Libre country site.
price	object	Yes	Pricing information object.
price.current_price	number \| null	Yes	Current selling price in local currency.
price.original_price	number \| null	No	Price before discount, if discounted.
price.discount_percent	number \| null	No	Discount percentage off the original price.
price.currency	string	Yes	Three-letter currency code.
price.installments	string \| null	No	Installment offer text.
rating	number \| null	No	Average review score on a 5.0 scale.
review_count	integer	No	Total number of reviews.
brand	string \| null	No	Brand name.
sku	string \| null	No	Seller SKU, when published.
gtin	string \| null	No	GTIN / barcode, when published.
in_stock	boolean	No	True if the product is available to buy.
available_quantity	string \| null	No	Stock text, e.g. '+50 disponibles'.
free_shipping	boolean \| null	No	True if shipping is free.
fulfillment	string \| null	No	Logistics type, e.g. 'fulfillment' (shipped by Mercado Libre) or 'cross_docking'.
seller	object	No	Seller information.
seller.name	string \| null	No	Seller or official store name.
seller.id	string \| null	No	Seller identifier.
seller.official_store	boolean	No	True if sold by an official store.
seller.reputation_level	string \| null	No	Seller reputation level, e.g. '5_green'.
seller.power_seller_status	string \| null	No	MercadoLíder status, e.g. 'platinum'.
images	array<string>	No	Product image URLs.
description	string \| null	No	Seller's product description text.
specifications	object	No	Key-value dictionary of product specifications.
variations	array<object>	No	Variation pickers such as color or size.
variations[].name	string	No	Variation attribute name, e.g. 'Color'.
variations[].selected	string \| null	No	Currently selected option.
variations[].options	array<string>	No	Available options.
breadcrumbs	array<string>	No	Category path.
category_id	string \| null	No	Mercado Libre category identifier.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/mercadolibre/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/etsy/products/search

Etsy Product Search

POST /api/v1/etsy/products/search

Search Etsy by keyword and get matching listings with titles, prices and discounts, shop names and ratings, badges, free-shipping flags and images.

Overview

Search Etsy by keyword and get matching listings with titles, prices and discounts, shop names and ratings, badges, free-shipping flags and images.

POST /api/v1/etsy/products/search

Method: POST Path: /api/v1/etsy/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 12, the first page of results).
location	string	Optional	Two-letter country code (default US). Prices are shown in that country's currency.
query	string	Required	Search keywords, e.g. "leather duffle bag"

Request Example

Etsy Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/etsy/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "12", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "location": "string",
  "returned_results": 0,
  "results": [
    {
      "listing_id": "1234567890",
      "title": "string",
      "url": "https://example.com/...",
      "price": {
        "current_price": 0.0,
        "original_price": 0.0,
        "discount_percent": 0,
        "currency": "USD",
        "currency_symbol": "string"
      },
      "shop_rating": 0.0,
      "shop_review_count": 0,
      "shop_name": "string",
      "shop_id": "1234567890",
      "image": "string",
      "badges": [
        "string"
      ],
      "free_shipping": false,
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Etsy Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	Search keywords that were queried.
location	string	No	Two-letter country code the search was run from; prices are shown in that country's currency.
returned_results	integer	Yes	Number of listings returned in this response.
results	array<object>	Yes	Listings matching the query, in Etsy's result order (sponsored listings included and flagged).
results[].listing_id	string	Yes	Etsy listing ID.
results[].title	string	Yes	Listing title.
results[].url	string	Yes	Listing page URL.
results[].price	object	Yes	Price shown on the result card.
results[].price.current_price	number \| null	No	Current (sale) price.
results[].price.original_price	number \| null	No	Price before discount, when the listing is on sale.
results[].price.discount_percent	integer \| null	No	Discount percentage, when the listing is on sale.
results[].price.currency	string \| null	No	ISO currency code, e.g. USD.
results[].price.currency_symbol	string \| null	No	Currency symbol as shown, e.g. $.
results[].shop_rating	number \| null	No	Seller's overall shop rating out of 5.
results[].shop_review_count	integer \| null	No	Approximate number of reviews for the seller's shop.
results[].shop_name	string \| null	No	Name of the seller's shop.
results[].shop_id	string \| null	No	Etsy shop ID.
results[].image	string \| null	No	Thumbnail image URL.
results[].badges	array<string>	No	Badges shown on the card, e.g. Bestseller, Popular now.
results[].free_shipping	boolean	No	Whether the card advertises free shipping.
results[].sponsored	boolean	No	Whether the result is a sponsored (ad) placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/etsy/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,12,US

Pricing & Rate Limits

Endpoint Pricing

$0.0032 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/etsy/products/details

Etsy Product Details

POST /api/v1/etsy/products/details

Get listing details from an Etsy product URL, including price and discount, stock, variations, ratings and reviews, shipping, materials, images, description and shop information.

Overview

Get listing details from an Etsy product URL, including price and discount, stock, variations, ratings and reviews, shipping, materials, images, description and shop information.

POST /api/v1/etsy/products/details

Method: POST Path: /api/v1/etsy/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code (default US). Prices and shipping are shown for that country.
product_url	string	Required	Full Etsy listing URL (e.g. https://www.etsy.com/listing/1016735270/leather-duffel-weekender-bag-men).

Request Example

Etsy Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/etsy/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "listing_id": "1234567890",
  "title": "string",
  "url": "https://example.com/...",
  "location": "string",
  "description": "string",
  "price": {
    "current_price": 0.0,
    "min_price": 0.0,
    "max_price": 0.0,
    "original_price": 0.0,
    "discount_percent": 0,
    "currency": "USD"
  },
  "availability": "string",
  "quantity_available": 0.0,
  "rating": 0.0,
  "review_count": 0.0,
  "category": "string",
  "breadcrumbs": [
    "string"
  ],
  "materials": [
    "string"
  ],
  "images": [
    "string"
  ],
  "variations": [
    {
      "name": "string",
      "options": [
        {
          "value": "string",
          "sold_out": false
        }
      ]
    }
  ],
  "shipping": {
    "cost": 0.0,
    "currency": "USD",
    "ships_from": "string",
    "ships_to": "string",
    "handling_days_min": 0.0,
    "handling_days_max": 0.0,
    "transit_days_min": 0.0,
    "transit_days_max": 0.0
  },
  "shop": {
    "name": "string",
    "shop_id": "1234567890",
    "url": "https://example.com/...",
    "logo": "string",
    "rating": 0.0,
    "review_count": 0,
    "sales": 0,
    "star_seller": false
  },
  "listed_on": "string",
  "reviews": [
    {
      "rating": 0.0,
      "date": "2026-01-01T12:00:00Z",
      "author": "string",
      "text": "string"
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Etsy Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
listing_id	string	Yes	Etsy listing ID.
title	string	Yes	Listing title.
url	string	Yes	Canonical listing URL.
location	string	No	Two-letter country code the listing was viewed from; prices and shipping apply to that country.
description	string \| null	No	Full listing description written by the seller.
price	object	Yes	Listing price; listings with variations have a price range.
price.current_price	number \| null	No	Current (sale) price of the default option.
price.min_price	number \| null	No	Lowest price across variations.
price.max_price	number \| null	No	Highest price across variations.
price.original_price	number \| null	No	Price before discount, when the listing is on sale.
price.discount_percent	integer \| null	No	Discount percentage, when the listing is on sale.
price.currency	string \| null	No	ISO currency code, e.g. USD.
availability	string \| null	No	Stock status: in_stock, out_of_stock, limited or pre_order.
quantity_available	number \| null	No	Quantity the seller has available.
rating	number \| null	No	Average rating for this item out of 5.
review_count	number \| null	No	Number of reviews for this item.
category	string \| null	No	Category path, e.g. Bags & Purses < Luggage & Travel < Duffel Bags.
breadcrumbs	array<string>	No	Category breadcrumb names from top level down.
materials	array<string>	No	Materials listed by the seller.
images	array<string>	No	Full-size image URLs.
variations	array<object>	No	Selectable options such as size, color or personalization.
variations[].name	string	No	Option name, e.g. Size.
variations[].options	array<object>	No
variations[].options[].value	string	No	Option value as shown, including any price.
variations[].options[].sold_out	boolean	No	Whether this option is sold out.
shipping	object	No	Shipping to the requested country, when the seller publishes it.
shipping.cost	number \| null	No	Shipping cost (0 for free shipping).
shipping.currency	string \| null	No	Currency of the shipping cost.
shipping.ships_from	string \| null	No	Country code the item ships from.
shipping.ships_to	string \| null	No	Country code the shipping cost applies to.
shipping.handling_days_min	number \| null	No	Minimum processing time in days.
shipping.handling_days_max	number \| null	No	Maximum processing time in days.
shipping.transit_days_min	number \| null	No	Minimum transit time in days.
shipping.transit_days_max	number \| null	No	Maximum transit time in days.
shop	object	No	The seller's shop.
shop.name	string \| null	No	Shop name.
shop.shop_id	string \| null	No	Etsy shop ID.
shop.url	string \| null	No	Shop page URL.
shop.logo	string \| null	No	Shop logo image URL.
shop.rating	number \| null	No	Overall shop rating out of 5.
shop.review_count	integer \| null	No	Approximate number of shop reviews.
shop.sales	integer \| null	No	Approximate number of sales the shop has made.
shop.star_seller	boolean	No	Whether the shop has Etsy's Star Seller badge.
listed_on	string \| null	No	Date the listing was last listed or renewed, e.g. Nov 4, 2026.
reviews	array<object>	No	Recent reviews shown on the listing page.
reviews[].rating	number \| null	No	Star rating out of 5.
reviews[].date	string \| null	No	Review date (YYYY-MM-DD).
reviews[].author	string \| null	No	Reviewer name.
reviews[].text	string \| null	No	Review text.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/etsy/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0032 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/asos/products/search

ASOS Product Search

POST /api/v1/asos/products/search

Search ASOS by keyword and get matching fashion products with titles, brands, prices and discounts, colours, images and selling-fast flags.

Overview

Search ASOS by keyword and get matching fashion products with titles, brands, prices and discounts, colours, images and selling-fast flags.

POST /api/v1/asos/products/search

Method: POST Path: /api/v1/asos/products/search Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of search results to return (up to 200).
location	string	Optional	Two-letter country code of the ASOS store to search (default US). Supported: US, GB, AU, FR, DE, AT, IT, ES, NL, SE, DK, PL, PR. Prices are in that store's currency.
query	string	Required	Search keywords, e.g. "wide leg jeans"

Request Example

ASOS Product Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/asos/products/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "48", "location": "US", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "location": "string",
  "store": "string",
  "total_results": 0,
  "returned_results": 0,
  "results": [
    {
      "product_id": "1234567890",
      "title": "string",
      "brand": "string",
      "url": "https://example.com/...",
      "price": {
        "current_price": 0.0,
        "formatted_current_price": "string",
        "original_price": 0.0,
        "discount_percent": 0,
        "lowest_price_30_days": 0.0,
        "currency": "USD",
        "on_sale": false,
        "is_outlet_price": false
      },
      "colour": "string",
      "colour_way_id": "1234567890",
      "has_more_colours": false,
      "product_code": "string",
      "image": "string",
      "additional_images": [
        "string"
      ],
      "video": "string",
      "is_selling_fast": false,
      "is_restocking_soon": false,
      "is_new": false,
      "sponsored": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "ASOS Product Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	Search keywords that were queried.
location	string	No	Two-letter country code of the store that was searched.
store	string	No	ASOS store code, e.g. US, COM (United Kingdom), FR.
total_results	integer	No	Total number of products ASOS reports for the query.
returned_results	integer	Yes	Number of products returned in this response.
results	array<object>	Yes	Products matching the query, in ASOS's result order.
results[].product_id	string	Yes	ASOS product ID.
results[].title	string	Yes	Product name.
results[].brand	string \| null	No	Brand name.
results[].url	string	Yes	Product page URL in the selected store.
results[].price	object	Yes	Price shown on the result card.
results[].price.current_price	number \| null	No	Current (sale) price.
results[].price.formatted_current_price	string \| null	No	Current price as displayed, e.g. $66.99.
results[].price.original_price	number \| null	No	Price before markdown, when the product is on sale.
results[].price.discount_percent	integer \| null	No	Discount percentage, when the product is on sale.
results[].price.lowest_price_30_days	number \| null	No	Lowest price in the last 30 days, where the store shows it.
results[].price.currency	string \| null	No	ISO currency code, e.g. USD.
results[].price.on_sale	boolean	No	Whether the product is marked down.
results[].price.is_outlet_price	boolean	No	Whether the price is an outlet price.
results[].colour	string \| null	No	Colour of the product shown.
results[].colour_way_id	string \| null	No	ID of the colour variant shown.
results[].has_more_colours	boolean	No	Whether the product comes in other colours.
results[].product_code	string \| null	No	ASOS product code.
results[].image	string \| null	No	Main image URL.
results[].additional_images	array<string>	No	Additional image URLs.
results[].video	string \| null	No	Catwalk video URL, when available.
results[].is_selling_fast	boolean	No	Whether the product is flagged as selling fast.
results[].is_restocking_soon	boolean	No	Whether the product is flagged as restocking soon.
results[].is_new	boolean	No	Whether the product is flagged as new.
results[].sponsored	boolean	No	Whether the result is a sponsored placement.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/asos/products/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,48,US

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/asos/products/details

ASOS Product Details

POST /api/v1/asos/products/details

Get product details from an ASOS product URL, including price and discount, stock per size, colour, description, fit and care information, materials, ratings and recent reviews, and images.

Overview

Get product details from an ASOS product URL, including price and discount, stock per size, colour, description, fit and care information, materials, ratings and recent reviews, and images.

POST /api/v1/asos/products/details

Method: POST Path: /api/v1/asos/products/details Category: E-Commerce

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
location	string	Optional	Two-letter country code of the ASOS store to read prices and stock from (default US). Supported: US, GB, AU, FR, DE, AT, IT, ES, NL, SE, DK, PL, PR.
product_url	string	Required	Full ASOS product URL (e.g. https://www.asos.com/us/collusion/collusion-wide-leg-chambray-denim-jeans-in-rinse-wash/prd/210425806).

Request Example

ASOS Product Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/asos/products/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "product_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "product_id": "1234567890",
  "product_code": "string",
  "title": "string",
  "brand": "string",
  "url": "https://example.com/...",
  "location": "string",
  "store": "string",
  "price": {
    "current_price": 0.0,
    "formatted_current_price": "string",
    "original_price": 0.0,
    "formatted_original_price": "string",
    "discount_percent": 0,
    "lowest_price_30_days": 0.0,
    "currency": "USD",
    "on_sale": false,
    "is_outlet_price": false
  },
  "in_stock": false,
  "is_restocking_soon": false,
  "is_discontinued": false,
  "selling_fast": false,
  "colour": "string",
  "total_colours": 0,
  "gender": "string",
  "product_type": "string",
  "fit_type": "string",
  "one_size": false,
  "sizes": [
    {
      "variant_id": "1234567890",
      "size": "string",
      "brand_size": "string",
      "colour": "string",
      "sku": "string",
      "in_stock": false,
      "low_in_stock": false,
      "price": 0.0
    }
  ],
  "description": "string",
  "description_points": [
    "string"
  ],
  "brand_description": "string",
  "size_and_fit": "string",
  "care_info": "string",
  "materials": "string",
  "country_of_manufacture": "string",
  "rating": {
    "average": 0.0,
    "review_count": 0,
    "percentage_recommended": 0.0,
    "distribution": {}
  },
  "recent_reviews": [
    {
      "rating": 0,
      "title": "string",
      "text": "string",
      "date": "2026-01-01T12:00:00Z",
      "verified_purchase": false
    }
  ],
  "breadcrumbs": [
    "string"
  ],
  "images": [
    "string"
  ],
  "video": "string",
  "save_count": 0,
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "ASOS Product Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
product_id	string	Yes	ASOS product ID.
product_code	string \| null	No	ASOS product code.
title	string	Yes	Product name.
brand	string \| null	No	Brand name.
url	string	Yes	Product page URL in the selected store.
location	string	No	Two-letter country code of the store the details were read from.
store	string	No	ASOS store code, e.g. US, COM (United Kingdom), FR.
price	object	Yes	Current price of the product.
price.current_price	number \| null	No	Current (sale) price.
price.formatted_current_price	string \| null	No	Current price as displayed, e.g. $66.99.
price.original_price	number \| null	No	Price before markdown, when the product is on sale.
price.formatted_original_price	string \| null	No	Original price as displayed, when the product is on sale.
price.discount_percent	integer \| null	No	Discount percentage, when the product is on sale.
price.lowest_price_30_days	number \| null	No	Lowest price in the last 30 days, where the store shows it.
price.currency	string \| null	No	ISO currency code, e.g. USD.
price.on_sale	boolean	No	Whether the product is marked down.
price.is_outlet_price	boolean	No	Whether the price is an outlet price.
in_stock	boolean	Yes	Whether any size is in stock.
is_restocking_soon	boolean	No	Whether the product is flagged as restocking soon.
is_discontinued	boolean	No	Whether the product is discontinued.
selling_fast	boolean	No	Whether the product is flagged as selling fast.
colour	string \| null	No	Colour of the product.
total_colours	integer \| null	No	Number of colours the product comes in.
gender	string \| null	No	Department, e.g. Women, Men.
product_type	string \| null	No	Product type, e.g. Jeans.
fit_type	string \| null	No	Fit, e.g. Wide, Slim.
one_size	boolean	No	Whether the product is one size.
sizes	array<object>	Yes	Sizes with stock and price.
sizes[].variant_id	string	Yes	Variant ID.
sizes[].size	string \| null	No	Size label in the store's size schema.
sizes[].brand_size	string \| null	No	Size label used by the brand.
sizes[].colour	string \| null	No	Colour of this variant.
sizes[].sku	string \| null	No	Variant SKU.
sizes[].in_stock	boolean	Yes	Whether this size is in stock.
sizes[].low_in_stock	boolean	No	Whether this size is low in stock.
sizes[].price	number \| null	No	Current price of this size.
description	string \| null	No	Product description as plain text.
description_points	array<string>	No	Description split into its lines and bullet points.
brand_description	string \| null	No	About the brand.
size_and_fit	string \| null	No	Size and fit notes, e.g. model's height and size worn.
care_info	string \| null	No	Care instructions.
materials	string \| null	No	Fabric and material composition.
country_of_manufacture	string \| null	No	Two-letter country code of manufacture.
rating	object	No	Customer ratings summary.
rating.average	number \| null	No	Average rating out of 5.
rating.review_count	integer	No	Number of reviews.
rating.percentage_recommended	number \| null	No	Percentage of reviewers who recommend the product.
rating.distribution	object	No	Number of reviews per star rating (keys 1 to 5).
recent_reviews	array<object>	No	Most recent reviews shown on the product page.
recent_reviews[].rating	integer \| null	No	Star rating.
recent_reviews[].title	string \| null	No	Review title.
recent_reviews[].text	string \| null	No	Review text.
recent_reviews[].date	string \| null	No	Review date (YYYY-MM-DD).
recent_reviews[].verified_purchase	boolean	No	Whether the reviewer is a verified purchaser.
breadcrumbs	array<string>	No	Category path, e.g. Women > Jeans.
images	array<string>	No	Product image URLs.
video	string \| null	No	Catwalk video URL, when available.
save_count	integer \| null	No	Number of shoppers who saved the product, when shown.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/asos/products/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

product_url,location
example,US

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/monster/jobs/search

Monster Job Search

POST /api/v1/monster/jobs/search

Search Monster.com job listings by keyword and location and get matching jobs with titles, companies, locations, salaries, employment types, posting dates, summaries and apply links.

Overview

Search Monster.com job listings by keyword and location and get matching jobs with titles, companies, locations, salaries, employment types, posting dates, summaries and apply links.

POST /api/v1/monster/jobs/search

Method: POST Path: /api/v1/monster/jobs/search Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of jobs to return (up to 20).
location	string	Optional	US city, state or ZIP code to search around, e.g. "New York, NY". Leave empty to search all of the US.
query	string	Required	Job title, skill or keywords, e.g. "product manager"

Request Example

Monster Job Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/monster/jobs/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "20", "location": "example", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "location": "string",
  "search_url": "https://example.com/...",
  "total_results": 0,
  "returned_results": 0,
  "results": [
    {
      "job_id": "1234567890",
      "title": "string",
      "url": "https://example.com/...",
      "company": "string",
      "location": "string",
      "locations": [
        {
          "city": "string",
          "region": "string",
          "postal_code": "string",
          "country": "string",
          "display": "string",
          "latitude": 0.0,
          "longitude": 0.0
        }
      ],
      "remote": "string",
      "salary": {
        "min": 0.0,
        "max": 0.0,
        "currency": "USD",
        "unit": "string"
      },
      "employment_types": [
        "string"
      ],
      "date_posted": "string",
      "date_recency": "string",
      "short_description": "string",
      "apply_type": "string",
      "apply_url": "https://example.com/...",
      "promoted": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Monster Job Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	Search keywords that were queried.
location	string \| null	No	Location that was searched, or null for all of the US.
search_url	string	No	Monster search page URL for this query.
total_results	integer	No	Estimated total number of jobs Monster reports for the search.
returned_results	integer	Yes	Number of jobs returned in this response.
results	array<object>	Yes	Jobs matching the search, in Monster's result order.
results[].job_id	string	Yes	Monster job ID.
results[].title	string	Yes	Job title.
results[].url	string \| null	Yes	Monster job page URL.
results[].company	string \| null	No	Hiring company name.
results[].location	string \| null	No	Primary job location, e.g. "New York, NY".
results[].locations	array<object>	No	All job locations.
results[].locations[].city	string \| null	No	City.
results[].locations[].region	string \| null	No	State or region code.
results[].locations[].postal_code	string \| null	No	Postal / ZIP code.
results[].locations[].country	string \| null	No	Country code or name.
results[].locations[].display	string \| null	No	Human-readable location, e.g. "New York, NY".
results[].locations[].latitude	number \| null	No	Latitude.
results[].locations[].longitude	number \| null	No	Longitude.
results[].remote	string \| null	No	Work arrangement, e.g. onsite, remote or hybrid.
results[].salary	object \| null	No	Pay range when the posting includes one.
results[].salary.min	number \| null	No	Minimum pay.
results[].salary.max	number \| null	No	Maximum pay.
results[].salary.currency	string \| null	No	Currency code, e.g. USD.
results[].salary.unit	string \| null	No	Pay period, e.g. YEAR or HOUR.
results[].employment_types	array<string>	No	Employment types, e.g. full time, contractor.
results[].date_posted	string \| null	No	Date the job was posted (ISO 8601).
results[].date_recency	string \| null	No	Relative posting age, e.g. "6 days ago".
results[].short_description	string \| null	No	Short summary of the job.
results[].apply_type	string \| null	No	How to apply, e.g. offsite or integrated.
results[].apply_url	string \| null	No	Application URL.
results[].promoted	boolean	No	Whether the listing is promoted.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/monster/jobs/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,location
example,20,example

Pricing & Rate Limits

Endpoint Pricing

$0.02 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/monster/jobs/details

Monster Job Details

POST /api/v1/monster/jobs/details

Get the full details of a Monster.com job posting from its URL, including the job description, company, locations, salary, employment type, posting and expiry dates, and apply link.

Overview

Get the full details of a Monster.com job posting from its URL, including the job description, company, locations, salary, employment type, posting and expiry dates, and apply link.

POST /api/v1/monster/jobs/details

Method: POST Path: /api/v1/monster/jobs/details Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
job_url	string	Required	Full Monster job URL (e.g. https://www.monster.com/job-openings/product-manager-new-york-ny--cf3815a4-2c84-4bb4-a180-ae2e8eb7f8f1).

Request Example

Monster Job Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/monster/jobs/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "job_id": "1234567890",
  "title": "string",
  "url": "https://example.com/...",
  "company": "string",
  "location": "string",
  "locations": [
    {
      "city": "string",
      "region": "string",
      "postal_code": "string",
      "country": "string",
      "display": "string",
      "latitude": 0.0,
      "longitude": 0.0
    }
  ],
  "remote": "string",
  "salary": {
    "min": 0.0,
    "max": 0.0,
    "currency": "USD",
    "unit": "string"
  },
  "employment_types": [
    "string"
  ],
  "date_posted": "string",
  "date_recency": "string",
  "short_description": "string",
  "apply_type": "string",
  "apply_url": "https://example.com/...",
  "promoted": false,
  "description": "string",
  "description_html": "string",
  "company_description": "string",
  "company_logo": "string",
  "company_url": "https://example.com/...",
  "industry": "string",
  "reference_id": "1234567890",
  "valid_through": "string",
  "status": "string",
  "created_date": "2026-01-01T12:00:00Z",
  "modified_date": "2026-01-01T12:00:00Z",
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Monster Job Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
job_id	string	Yes	Monster job ID.
title	string	Yes	Job title.
url	string	Yes	Monster job page URL.
company	string \| null	No	Hiring company name.
location	string \| null	No	Primary job location, e.g. "New York, NY".
locations	array<object>	No	All job locations.
locations[].city	string \| null	No	City.
locations[].region	string \| null	No	State or region code.
locations[].postal_code	string \| null	No	Postal / ZIP code.
locations[].country	string \| null	No	Country code or name.
locations[].display	string \| null	No	Human-readable location, e.g. "New York, NY".
locations[].latitude	number \| null	No	Latitude.
locations[].longitude	number \| null	No	Longitude.
remote	string \| null	No	Work arrangement, e.g. onsite, remote or hybrid.
salary	object \| null	No	Pay range when the posting includes one.
salary.min	number \| null	No	Minimum pay.
salary.max	number \| null	No	Maximum pay.
salary.currency	string \| null	No	Currency code, e.g. USD.
salary.unit	string \| null	No	Pay period, e.g. YEAR or HOUR.
employment_types	array<string>	No	Employment types, e.g. full time, contractor.
date_posted	string \| null	No	Date the job was posted (ISO 8601).
date_recency	string \| null	No	Relative posting age, e.g. "6 days ago".
short_description	string \| null	No	Short summary of the job.
apply_type	string \| null	No	How to apply, e.g. offsite or integrated.
apply_url	string \| null	No	Application URL.
promoted	boolean	No	Whether the listing is promoted.
description	string \| null	No	Full job description as plain text.
description_html	string \| null	No	Full job description as HTML.
company_description	string \| null	No	About the company, as plain text.
company_logo	string \| null	No	Company logo URL.
company_url	string \| null	No	Company website URL.
industry	string \| null	No	Industry of the hiring company.
reference_id	string \| null	No	Employer's own reference number for the job.
valid_through	string \| null	No	Date the posting expires (ISO 8601).
status	string \| null	No	Posting status, e.g. active.
created_date	string \| null	No	Date the job was added to Monster (ISO 8601).
modified_date	string \| null	No	Date the job was last updated (ISO 8601).

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/monster/jobs/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

job_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/glassdoor/companies/reviews

Glassdoor Company Reviews

POST /api/v1/glassdoor/companies/reviews

Get a company's Glassdoor employee ratings from its Glassdoor URL, including overall and category ratings, rating distributions, CEO approval, review counts, company profile and featured employee reviews with pros and cons.

Overview

POST /api/v1/glassdoor/companies/reviews

Method: POST Path: /api/v1/glassdoor/companies/reviews Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
company_url	string	Required	Glassdoor company URL (e.g. https://www.glassdoor.com/Reviews/Google-Reviews-E9079.htm). The company's Salary, Interview or Overview page URL also works.

Request Example

Glassdoor Company Reviews Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/glassdoor/companies/reviews" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "company": {
    "employer_id": 0,
    "name": "string",
    "legal_name": "string",
    "url": "https://example.com/...",
    "website": "string",
    "headquarters": "string",
    "size": "string",
    "industry": "string",
    "sector": "string",
    "description": "string",
    "logo": "string"
  },
  "review_count": 0,
  "all_review_count": 0,
  "rated_review_count": 0,
  "ratings": {
    "overall": 0.0,
    "career_opportunities": 0.0,
    "compensation_and_benefits": 0.0,
    "culture_and_values": 0.0,
    "diversity_and_inclusion": 0.0,
    "senior_management": 0.0,
    "work_life_balance": 0.0,
    "recommend_to_friend": 0.0,
    "ceo_approval": 0.0,
    "positive_business_outlook": 0.0
  },
  "rating_distribution": {
    "overall": {},
    "career_opportunities": {},
    "compensation_and_benefits": {},
    "culture_and_values": {},
    "diversity_and_inclusion": {},
    "senior_management": {},
    "work_life_balance": {},
    "recommend_to_friend": {
      "recommend": 0,
      "would_not_recommend": 0
    }
  },
  "ceo": {
    "name": "string",
    "title": "string",
    "photo": "string"
  },
  "reviews_last_7_days": 0,
  "reviews_last_30_days": 0,
  "reviews": [
    {
      "review_id": "1234567890",
      "title": "string",
      "rating": 0.0,
      "date": "2026-01-01T12:00:00Z",
      "job_title": "string",
      "location": "string",
      "is_current_employee": false,
      "employment_status": "string",
      "years_employed": 0,
      "pros": "string",
      "cons": "string",
      "advice_to_management": "string",
      "ratings": {},
      "recommends": "string",
      "ceo_approval": "string",
      "business_outlook": "string",
      "helpful_count": 0,
      "not_helpful_count": 0,
      "featured": false,
      "employer_responses": [
        {
          "response": "string",
          "date": "2026-01-01T12:00:00Z",
          "responder": "string"
        }
      ]
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Glassdoor Company Reviews",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
company	object	Yes
company.employer_id	integer	Yes	Glassdoor employer ID.
company.name	string \| null	No	Company name.
company.legal_name	string \| null	No	Full company name as registered on Glassdoor.
company.url	string	Yes	Glassdoor page URL.
company.website	string \| null	No	Company website.
company.headquarters	string \| null	No	Headquarters location, e.g. "Mountain View, CA".
company.size	string \| null	No	Company size, e.g. "10000+ Employees".
company.industry	string \| null	No	Industry.
company.sector	string \| null	No	Sector.
company.description	string \| null	No	Company overview.
company.logo	string \| null	No	Company logo URL.
review_count	integer \| null	No	Number of English reviews from regular and part-time employees (the set the ratings cover).
all_review_count	integer \| null	No	Total number of reviews in all languages and employment types.
rated_review_count	integer \| null	No	Number of reviews counted in the rating averages.
ratings	object	Yes	Average ratings (1-5 stars) and shares of reviewers (0-1).
ratings.overall	number \| null	No	Overall rating (1-5).
ratings.career_opportunities	number \| null	No	Career opportunities rating (1-5).
ratings.compensation_and_benefits	number \| null	No	Compensation and benefits rating (1-5).
ratings.culture_and_values	number \| null	No	Culture and values rating (1-5).
ratings.diversity_and_inclusion	number \| null	No	Diversity and inclusion rating (1-5).
ratings.senior_management	number \| null	No	Senior management rating (1-5).
ratings.work_life_balance	number \| null	No	Work/life balance rating (1-5).
ratings.recommend_to_friend	number \| null	No	Share of reviewers who would recommend the company to a friend (0-1).
ratings.ceo_approval	number \| null	No	Share of reviewers who approve of the CEO (0-1).
ratings.positive_business_outlook	number \| null	No	Share of reviewers with a positive business outlook (0-1).
rating_distribution	object	No	Number of reviews per star rating for each rating category.
rating_distribution.overall	object	No	Number of reviews giving each star rating (1-5).
rating_distribution.career_opportunities	object	No	Number of reviews giving each star rating (1-5).
rating_distribution.compensation_and_benefits	object	No	Number of reviews giving each star rating (1-5).
rating_distribution.culture_and_values	object	No	Number of reviews giving each star rating (1-5).
rating_distribution.diversity_and_inclusion	object	No	Number of reviews giving each star rating (1-5).
rating_distribution.senior_management	object	No	Number of reviews giving each star rating (1-5).
rating_distribution.work_life_balance	object	No	Number of reviews giving each star rating (1-5).
rating_distribution.recommend_to_friend	object	No
rating_distribution.recommend_to_friend.recommend	integer \| null	No	Reviewers who would recommend the company.
rating_distribution.recommend_to_friend.would_not_recommend	integer \| null	No	Reviewers who would not recommend the company.
ceo	object \| null	No	CEO the approval rating refers to.
ceo.name	string \| null	No	CEO name.
ceo.title	string \| null	No	Title.
ceo.photo	string \| null	No	Photo URL.
reviews_last_7_days	integer \| null	No	Reviews posted in the last 7 days.
reviews_last_30_days	integer \| null	No	Reviews posted in the last 30 days.
reviews	array<object>	Yes	Featured employee reviews shown on the company's reviews page.
reviews[].review_id	string	Yes	Glassdoor review ID.
reviews[].title	string \| null	No	Review headline.
reviews[].rating	number \| null	No	Overall rating given (1-5).
reviews[].date	string \| null	No	Date the review was posted (ISO 8601).
reviews[].job_title	string \| null	No	Reviewer's job title.
reviews[].location	string \| null	No	Reviewer's work location.
reviews[].is_current_employee	boolean \| null	No	Whether the reviewer still works there.
reviews[].employment_status	string \| null	No	Employment type, e.g. regular, part time.
reviews[].years_employed	integer \| null	No	Length of employment in years, as reported by the reviewer.
reviews[].pros	string \| null	No	Pros.
reviews[].cons	string \| null	No	Cons.
reviews[].advice_to_management	string \| null	No	Advice to management.
reviews[].ratings	object	No	Category ratings given by the reviewer (1-5, null when not rated).
reviews[].recommends	string \| null	No	Would recommend to a friend: positive, negative or null.
reviews[].ceo_approval	string \| null	No	CEO approval: positive, negative, neutral or no opinion.
reviews[].business_outlook	string \| null	No	Business outlook: positive, negative or neutral.
reviews[].helpful_count	integer \| null	No	Times the review was marked helpful.
reviews[].not_helpful_count	integer \| null	No	Times the review was marked not helpful.
reviews[].featured	boolean	No	Whether the review is featured.
reviews[].employer_responses	array<object>	No	Replies from the company.
reviews[].employer_responses[].response	string	No	Reply text.
reviews[].employer_responses[].date	string \| null	No	Reply date.
reviews[].employer_responses[].responder	string \| null	No	Responder's job title.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/glassdoor/companies/reviews?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

company_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/glassdoor/companies/salaries

Glassdoor Company Salaries

POST /api/v1/glassdoor/companies/salaries

Get a company's Glassdoor salary report from its Glassdoor URL, with base and total pay percentiles for its most-reported job titles, salary counts and company profile.

Overview

Get a company's Glassdoor salary report from its Glassdoor URL, with base and total pay percentiles for its most-reported job titles, salary counts and company profile.

POST /api/v1/glassdoor/companies/salaries

Method: POST Path: /api/v1/glassdoor/companies/salaries Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
company_url	string	Required	Glassdoor company URL (e.g. https://www.glassdoor.com/Salary/Google-Salaries-E9079.htm). The company's Reviews, Interview or Overview page URL also works.

Request Example

Glassdoor Company Salaries Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/glassdoor/companies/salaries" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "company": {
    "employer_id": 0,
    "name": "string",
    "legal_name": "string",
    "url": "https://example.com/...",
    "website": "string",
    "headquarters": "string",
    "size": "string",
    "industry": "string",
    "sector": "string",
    "description": "string",
    "logo": "string"
  },
  "location": "string",
  "pay_period": "string",
  "salary_count": 0,
  "job_title_count": 0,
  "salaries": [
    {
      "job_title": "string",
      "job_title_id": 0,
      "salary_count": 0,
      "currency": "USD",
      "base_pay": {
        "p10": 0.0,
        "p25": 0.0,
        "p50": 0.0,
        "p75": 0.0,
        "p90": 0.0
      },
      "total_pay": {
        "p10": 0.0,
        "p25": 0.0,
        "p50": 0.0,
        "p75": 0.0,
        "p90": 0.0
      },
      "median_base_pay": 0.0,
      "median_total_pay": 0.0,
      "most_recent": "string"
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Glassdoor Company Salaries",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
company	object	Yes
company.employer_id	integer	Yes	Glassdoor employer ID.
company.name	string \| null	No	Company name.
company.legal_name	string \| null	No	Full company name as registered on Glassdoor.
company.url	string	Yes	Glassdoor page URL.
company.website	string \| null	No	Company website.
company.headquarters	string \| null	No	Headquarters location, e.g. "Mountain View, CA".
company.size	string \| null	No	Company size, e.g. "10000+ Employees".
company.industry	string \| null	No	Industry.
company.sector	string \| null	No	Sector.
company.description	string \| null	No	Company overview.
company.logo	string \| null	No	Company logo URL.
location	string \| null	No	Region the salary estimates cover, e.g. "United States".
pay_period	string \| null	No	Pay period of all amounts, e.g. annual or hourly (Glassdoor shows hourly pay for mostly-hourly employers).
salary_count	integer \| null	No	Total number of salaries reported for the company.
job_title_count	integer \| null	No	Number of job titles with salary data.
salaries	array<object>	Yes	Salary estimates for the company's most-reported job titles.
salaries[].job_title	string	Yes	Job title.
salaries[].job_title_id	integer \| null	No	Glassdoor job title ID.
salaries[].salary_count	integer \| null	No	Number of salaries reported for this job title.
salaries[].currency	string \| null	No	Currency code, e.g. USD.
salaries[].base_pay	object \| null	No	Pay percentiles (10th, 25th, median, 75th, 90th).
salaries[].base_pay.p10	number \| null	No
salaries[].base_pay.p25	number \| null	No
salaries[].base_pay.p50	number \| null	No
salaries[].base_pay.p75	number \| null	No
salaries[].base_pay.p90	number \| null	No
salaries[].total_pay	object \| null	No	Pay percentiles (10th, 25th, median, 75th, 90th).
salaries[].total_pay.p10	number \| null	No
salaries[].total_pay.p25	number \| null	No
salaries[].total_pay.p50	number \| null	No
salaries[].total_pay.p75	number \| null	No
salaries[].total_pay.p90	number \| null	No
salaries[].median_base_pay	number \| null	No	Median base pay.
salaries[].median_total_pay	number \| null	No	Median total pay (base plus bonus, stock and other pay).
salaries[].most_recent	string \| null	No	Date of the most recent salary report (ISO 8601).

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/glassdoor/companies/salaries?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

company_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/glassdoor/companies/interviews

Glassdoor Company Interviews

POST /api/v1/glassdoor/companies/interviews

Get a company's Glassdoor interview insights from its Glassdoor URL, including average difficulty, experience and source breakdowns, interview counts, company profile and recent interview reports.

Overview

Get a company's Glassdoor interview insights from its Glassdoor URL, including average difficulty, experience and source breakdowns, interview counts, company profile and recent interview reports.

POST /api/v1/glassdoor/companies/interviews

Method: POST Path: /api/v1/glassdoor/companies/interviews Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
company_url	string	Required	Glassdoor company URL (e.g. https://www.glassdoor.com/Interview/Google-Interview-Questions-E9079.htm). The company's Reviews, Salary or Overview page URL also works.

Request Example

Glassdoor Company Interviews Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/glassdoor/companies/interviews" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "company": {
    "employer_id": 0,
    "name": "string",
    "legal_name": "string",
    "url": "https://example.com/...",
    "website": "string",
    "headquarters": "string",
    "size": "string",
    "industry": "string",
    "sector": "string",
    "description": "string",
    "logo": "string"
  },
  "interview_count": 0,
  "question_count": 0,
  "average_difficulty": 0.0,
  "experience_counts": {},
  "source_counts": {},
  "newest_interview_date": "2026-01-01T12:00:00Z",
  "interviews": [
    {
      "interview_id": "1234567890",
      "job_title": "string",
      "location": "string",
      "date": "2026-01-01T12:00:00Z",
      "interview_date": "2026-01-01T12:00:00Z",
      "experience": "string",
      "difficulty": "string",
      "outcome": "string",
      "source": "string",
      "duration_days": 0,
      "process": "string",
      "questions": [
        "string"
      ],
      "helpful_count": 0,
      "featured": false
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Glassdoor Company Interviews",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
company	object	Yes
company.employer_id	integer	Yes	Glassdoor employer ID.
company.name	string \| null	No	Company name.
company.legal_name	string \| null	No	Full company name as registered on Glassdoor.
company.url	string	Yes	Glassdoor page URL.
company.website	string \| null	No	Company website.
company.headquarters	string \| null	No	Headquarters location, e.g. "Mountain View, CA".
company.size	string \| null	No	Company size, e.g. "10000+ Employees".
company.industry	string \| null	No	Industry.
company.sector	string \| null	No	Sector.
company.description	string \| null	No	Company overview.
company.logo	string \| null	No	Company logo URL.
interview_count	integer \| null	No	Total number of interview reports.
question_count	integer \| null	No	Total number of interview questions shared.
average_difficulty	number \| null	No	Average interview difficulty (1 = very easy, 5 = very difficult).
experience_counts	object	No	Number of interviews rated positive, neutral and negative.
source_counts	object	No	How candidates got the interview, e.g. applied online, recruiter, employee referral.
newest_interview_date	string \| null	No	Date of the newest interview report (ISO 8601).
interviews	array<object>	Yes	Most recent interview reports.
interviews[].interview_id	string	Yes	Glassdoor interview report ID.
interviews[].job_title	string \| null	No	Job interviewed for.
interviews[].location	string \| null	No	Interview location.
interviews[].date	string \| null	No	Date the report was posted (ISO 8601).
interviews[].interview_date	string \| null	No	Month of the interview (ISO 8601).
interviews[].experience	string \| null	No	Candidate experience: positive, neutral or negative.
interviews[].difficulty	string \| null	No	Difficulty, e.g. easy, average, difficult.
interviews[].outcome	string \| null	No	Outcome, e.g. accept offer, decline offer, no offer.
interviews[].source	string \| null	No	How the candidate got the interview.
interviews[].duration_days	integer \| null	No	Length of the hiring process in days.
interviews[].process	string \| null	No	Description of the interview process.
interviews[].questions	array<string>	No	Interview questions the candidate shared.
interviews[].helpful_count	integer \| null	No	Times the report was marked helpful.
interviews[].featured	boolean	No	Whether the report is featured.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/glassdoor/companies/interviews?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

company_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/crunchbase/organizations/search

Crunchbase Organization Search

POST /api/v1/crunchbase/organizations/search

Search Crunchbase by company name or keyword and get matching organizations with their Crunchbase URLs, permalinks, short descriptions and logos.

Overview

Search Crunchbase by company name or keyword and get matching organizations with their Crunchbase URLs, permalinks, short descriptions and logos.

POST /api/v1/crunchbase/organizations/search

Method: POST Path: /api/v1/crunchbase/organizations/search Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of organizations to return (1-25).
query	string	Required	Company name or keywords, e.g. "stripe"

Request Example

Crunchbase Organization Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/crunchbase/organizations/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "10", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "total_matches": 0,
  "results_count": 0,
  "results": [
    {
      "position": 0,
      "name": "string",
      "permalink": "https://example.com/...",
      "uuid": "1234567890",
      "url": "https://example.com/...",
      "short_description": "string",
      "logo": "string",
      "data_facets": [
        "string"
      ]
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Crunchbase Organization Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	The search query that was used.
total_matches	integer	No	Total number of organizations Crunchbase reports as matching the query.
results_count	integer	Yes	Number of organizations returned in this response.
results	array<object>	Yes	Matching organizations, best match first.
results[].position	integer	Yes	1-based rank of the organization in the results.
results[].name	string	Yes	Organization name.
results[].permalink	string	Yes	Crunchbase permalink (the last part of the organization URL).
results[].uuid	string \| null	No	Crunchbase organization identifier.
results[].url	string	Yes	Crunchbase organization URL, usable with the organization details endpoint.
results[].short_description	string \| null	No	One-line description of the organization.
results[].logo	string \| null	No	Organization logo image URL.
results[].data_facets	array<string>	No	Kinds of data Crunchbase holds for this organization (e.g. company, investor).

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/crunchbase/organizations/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit
example,10

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/crunchbase/organizations/details

Crunchbase Organization Details

POST /api/v1/crunchbase/organizations/details

Get a company's Crunchbase profile from its Crunchbase organization URL, including description, website, headquarters, industries, employee range, rank, founders, key people, funding rounds, investors, investments, acquisitions, similar companies, news and contact links.

Overview

POST /api/v1/crunchbase/organizations/details

Method: POST Path: /api/v1/crunchbase/organizations/details Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
organization_url	string	Required	Full Crunchbase organization URL (e.g. https://www.crunchbase.com/organization/stripe).

Request Example

Crunchbase Organization Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/crunchbase/organizations/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"organization_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "permalink": "https://example.com/...",
  "uuid": "1234567890",
  "name": "string",
  "legal_name": "string",
  "url": "https://example.com/...",
  "short_description": "string",
  "description": "string",
  "website": "string",
  "logo": "string",
  "operating_status": "string",
  "ipo_status": "string",
  "employee_count": "string",
  "last_funding_type": "string",
  "headquarters": {
    "city": "string",
    "region": "string",
    "country": "string",
    "continent": "string",
    "full": "string"
  },
  "location_groups": [
    "string"
  ],
  "industries": [
    "string"
  ],
  "industry_groups": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "hubs": [
    "string"
  ],
  "rank": {
    "crunchbase_rank": 0,
    "company_rank": 0,
    "rank_change_90d": 0.0
  },
  "contact": {
    "email": "user@example.com",
    "phone": "string"
  },
  "social_links": {
    "linkedin": "string",
    "twitter": "string",
    "facebook": "string"
  },
  "founders": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string"
    }
  ],
  "counts": {
    "funding_rounds": 0,
    "investors": 0,
    "lead_investors": 0,
    "investments": 0,
    "lead_investments": 0,
    "acquisitions": 0,
    "sub_organizations": 0,
    "current_employee_profiles": 0,
    "board_and_advisors": 0,
    "contacts": 0
  },
  "funding_rounds": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "investment_type": "string",
      "num_investors": 0,
      "lead_investors": [
        {
          "name": "string",
          "permalink": "https://example.com/...",
          "url": "https://example.com/...",
          "image": "string"
        }
      ]
    }
  ],
  "investors": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string",
      "is_lead_investor": false,
      "funding_round": "string"
    }
  ],
  "investments": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string",
      "funding_round": "string"
    }
  ],
  "acquisitions": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string"
    }
  ],
  "sub_organizations": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string",
      "ownership_type": "string"
    }
  ],
  "exits": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string",
      "short_description": "string"
    }
  ],
  "key_people": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string",
      "title": "string",
      "started_on": "string"
    }
  ],
  "board_and_advisors": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string",
      "role": "string"
    }
  ],
  "similar_companies": [
    {
      "name": "string",
      "permalink": "https://example.com/...",
      "url": "https://example.com/...",
      "image": "string"
    }
  ],
  "products": [
    {
      "name": "string",
      "description": "string"
    }
  ],
  "technology": {
    "monthly_website_visits": 0.0,
    "website_visits_change_pct": 0.0,
    "app_downloads": 0.0,
    "num_technologies_used": 0,
    "num_software_products_used": 0,
    "technologies": [
      {
        "name": "string",
        "categories": [
          "string"
        ]
      }
    ],
    "software_used": [
      "string"
    ]
  },
  "news": [
    {
      "title": "string",
      "publisher": "string",
      "author": "string",
      "url": "https://example.com/...",
      "date": "2026-01-01T12:00:00Z"
    }
  ],
  "awards": [
    {
      "title": "string",
      "description": "string",
      "date": "2026-01-01T12:00:00Z",
      "press_references": [
        {
          "title": "string",
          "publisher": "string",
          "url": "https://example.com/...",
          "posted_on": "string"
        }
      ]
    }
  ],
  "partnerships": [
    {
      "title": "string",
      "description": "string",
      "date": "2026-01-01T12:00:00Z",
      "press_references": [
        {
          "title": "string",
          "publisher": "string",
          "url": "https://example.com/...",
          "posted_on": "string"
        }
      ]
    }
  ],
  "product_launches": [
    {
      "title": "string",
      "description": "string",
      "date": "2026-01-01T12:00:00Z",
      "press_references": [
        {
          "title": "string",
          "publisher": "string",
          "url": "https://example.com/...",
          "posted_on": "string"
        }
      ]
    }
  ],
  "key_employee_changes": [
    {
      "title": "string",
      "description": "string",
      "date": "2026-01-01T12:00:00Z",
      "press_references": [
        {
          "title": "string",
          "publisher": "string",
          "url": "https://example.com/...",
          "posted_on": "string"
        }
      ]
    }
  ],
  "layoffs": [
    {
      "title": "string",
      "description": "string",
      "date": "2026-01-01T12:00:00Z",
      "press_references": [
        {
          "title": "string",
          "publisher": "string",
          "url": "https://example.com/...",
          "posted_on": "string"
        }
      ]
    }
  ],
  "offices": [
    {
      "description": "string",
      "opening_date": "2026-01-01T12:00:00Z",
      "press_references": [
        {
          "title": "string",
          "publisher": "string",
          "url": "https://example.com/...",
          "posted_on": "string"
        }
      ]
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Crunchbase Organization Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
permalink	string	Yes	Crunchbase permalink of the organization.
uuid	string \| null	No	Crunchbase organization identifier.
name	string	Yes	Organization name.
legal_name	string \| null	No	Registered legal name.
url	string	Yes	Crunchbase organization URL.
short_description	string \| null	No	One-line description.
description	string \| null	No	Full company description.
website	string \| null	No	Company website.
logo	string \| null	No	Company logo image URL.
operating_status	string \| null	No	Operating status, e.g. active or closed.
ipo_status	string \| null	No	IPO status, e.g. private or public.
employee_count	string \| null	No	Employee count range, e.g. 5001-10000.
last_funding_type	string \| null	No	Type of the most recent funding round, e.g. series c.
headquarters	object	No	Headquarters location.
headquarters.city	string \| null	No
headquarters.region	string \| null	No
headquarters.country	string \| null	No
headquarters.continent	string \| null	No
headquarters.full	string \| null	No	City, region and country joined.
location_groups	array<string>	No	Regional groupings, e.g. San Francisco Bay Area.
industries	array<string>	No
industry_groups	array<string>	No
tags	array<string>	No	Tags such as unicorn.
hubs	array<string>	No	Crunchbase hubs the organization belongs to.
rank	object	No
rank.crunchbase_rank	integer \| null	No
rank.company_rank	integer \| null	No
rank.rank_change_90d	number \| null	No
contact	object	No
contact.email	string \| null	No
contact.phone	string \| null	No
social_links	object	No
social_links.linkedin	string \| null	No
social_links.twitter	string \| null	No
social_links.facebook	string \| null	No
founders	array<object>	No
founders[].name	string	Yes
founders[].permalink	string \| null	No
founders[].url	string \| null	No	Crunchbase URL of the entity.
founders[].image	string \| null	No	Logo or profile image URL.
counts	object	No	Totals reported by Crunchbase.
counts.funding_rounds	integer \| null	No
counts.investors	integer \| null	No
counts.lead_investors	integer \| null	No
counts.investments	integer \| null	No
counts.lead_investments	integer \| null	No
counts.acquisitions	integer \| null	No
counts.sub_organizations	integer \| null	No
counts.current_employee_profiles	integer \| null	No
counts.board_and_advisors	integer \| null	No
counts.contacts	integer \| null	No
funding_rounds	array<object>	No	Most recent funding rounds.
funding_rounds[].name	string \| null	No
funding_rounds[].permalink	string \| null	No
funding_rounds[].url	string \| null	No
funding_rounds[].investment_type	string \| null	No
funding_rounds[].num_investors	integer \| null	No
funding_rounds[].lead_investors	array<object>	No
funding_rounds[].lead_investors[].name	string	Yes
funding_rounds[].lead_investors[].permalink	string \| null	No
funding_rounds[].lead_investors[].url	string \| null	No	Crunchbase URL of the entity.
funding_rounds[].lead_investors[].image	string \| null	No	Logo or profile image URL.
investors	array<object>	No	Recent investors in the organization.
investors[].name	string	Yes
investors[].permalink	string \| null	No
investors[].url	string \| null	No	Crunchbase URL of the entity.
investors[].image	string \| null	No	Logo or profile image URL.
investors[].is_lead_investor	boolean	No
investors[].funding_round	string \| null	No
investments	array<object>	No	Recent investments made by the organization.
investments[].name	string	Yes
investments[].permalink	string \| null	No
investments[].url	string \| null	No	Crunchbase URL of the entity.
investments[].image	string \| null	No	Logo or profile image URL.
investments[].funding_round	string \| null	No
acquisitions	array<object>	No	Recently acquired organizations.
acquisitions[].name	string	Yes
acquisitions[].permalink	string \| null	No
acquisitions[].url	string \| null	No	Crunchbase URL of the entity.
acquisitions[].image	string \| null	No	Logo or profile image URL.
sub_organizations	array<object>	No
sub_organizations[].name	string	Yes
sub_organizations[].permalink	string \| null	No
sub_organizations[].url	string \| null	No	Crunchbase URL of the entity.
sub_organizations[].image	string \| null	No	Logo or profile image URL.
sub_organizations[].ownership_type	string \| null	No
exits	array<object>	No	Portfolio companies that exited.
exits[].name	string	Yes
exits[].permalink	string \| null	No
exits[].url	string \| null	No	Crunchbase URL of the entity.
exits[].image	string \| null	No	Logo or profile image URL.
exits[].short_description	string \| null	No
key_people	array<object>	No	Featured current employees.
key_people[].name	string	Yes
key_people[].permalink	string \| null	No
key_people[].url	string \| null	No	Crunchbase URL of the entity.
key_people[].image	string \| null	No	Logo or profile image URL.
key_people[].title	string \| null	No
key_people[].started_on	string \| null	No
board_and_advisors	array<object>	No
board_and_advisors[].name	string	Yes
board_and_advisors[].permalink	string \| null	No
board_and_advisors[].url	string \| null	No	Crunchbase URL of the entity.
board_and_advisors[].image	string \| null	No	Logo or profile image URL.
board_and_advisors[].role	string \| null	No
similar_companies	array<object>	No	Competitors and similar organizations.
similar_companies[].name	string	Yes
similar_companies[].permalink	string \| null	No
similar_companies[].url	string \| null	No	Crunchbase URL of the entity.
similar_companies[].image	string \| null	No	Logo or profile image URL.
products	array<object>	No
products[].name	string \| null	No
products[].description	string \| null	No
technology	object	No	Website traffic, apps and technology usage.
technology.monthly_website_visits	number \| null	No
technology.website_visits_change_pct	number \| null	No	Month-over-month change in website visits (fraction, 0.14 = +14%).
technology.app_downloads	number \| null	No
technology.num_technologies_used	integer \| null	No
technology.num_software_products_used	integer \| null	No
technology.technologies	array<object>	No
technology.technologies[].name	string	No
technology.technologies[].categories	array<string>	No
technology.software_used	array<string>	No
news	array<object>	No	Recent news mentions.
news[].title	string \| null	No
news[].publisher	string \| null	No
news[].author	string \| null	No
news[].url	string \| null	No
news[].date	string \| null	No
awards	array<object>	No
awards[].title	string \| null	No
awards[].description	string \| null	No
awards[].date	string \| null	No	Event date (YYYY-MM-DD).
awards[].press_references	array<object>	No
awards[].press_references[].title	string \| null	No
awards[].press_references[].publisher	string \| null	No
awards[].press_references[].url	string \| null	No
awards[].press_references[].posted_on	string \| null	No
partnerships	array<object>	No
partnerships[].title	string \| null	No
partnerships[].description	string \| null	No
partnerships[].date	string \| null	No	Event date (YYYY-MM-DD).
partnerships[].press_references	array<object>	No
partnerships[].press_references[].title	string \| null	No
partnerships[].press_references[].publisher	string \| null	No
partnerships[].press_references[].url	string \| null	No
partnerships[].press_references[].posted_on	string \| null	No
product_launches	array<object>	No
product_launches[].title	string \| null	No
product_launches[].description	string \| null	No
product_launches[].date	string \| null	No	Event date (YYYY-MM-DD).
product_launches[].press_references	array<object>	No
product_launches[].press_references[].title	string \| null	No
product_launches[].press_references[].publisher	string \| null	No
product_launches[].press_references[].url	string \| null	No
product_launches[].press_references[].posted_on	string \| null	No
key_employee_changes	array<object>	No
key_employee_changes[].title	string \| null	No
key_employee_changes[].description	string \| null	No
key_employee_changes[].date	string \| null	No	Event date (YYYY-MM-DD).
key_employee_changes[].press_references	array<object>	No
key_employee_changes[].press_references[].title	string \| null	No
key_employee_changes[].press_references[].publisher	string \| null	No
key_employee_changes[].press_references[].url	string \| null	No
key_employee_changes[].press_references[].posted_on	string \| null	No
layoffs	array<object>	No
layoffs[].title	string \| null	No
layoffs[].description	string \| null	No
layoffs[].date	string \| null	No	Event date (YYYY-MM-DD).
layoffs[].press_references	array<object>	No
layoffs[].press_references[].title	string \| null	No
layoffs[].press_references[].publisher	string \| null	No
layoffs[].press_references[].url	string \| null	No
layoffs[].press_references[].posted_on	string \| null	No
offices	array<object>	No	Recent office openings.
offices[].description	string \| null	No
offices[].opening_date	string \| null	No
offices[].press_references	array<object>	No
offices[].press_references[].title	string \| null	No
offices[].press_references[].publisher	string \| null	No
offices[].press_references[].url	string \| null	No
offices[].press_references[].posted_on	string \| null	No

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/crunchbase/organizations/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

organization_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/pitchbook/profiles/search

PitchBook Profile Search

POST /api/v1/pitchbook/profiles/search

Search PitchBook by company, investor or firm name and get matching profiles with their type, PitchBook ID, profile URL and logo.

Overview

Search PitchBook by company, investor or firm name and get matching profiles with their type, PitchBook ID, profile URL and logo.

POST /api/v1/pitchbook/profiles/search

Method: POST Path: /api/v1/pitchbook/profiles/search Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of profiles to return from the page (1-15).
page	integer	Optional	Results page to return (15 profiles per page).
query	string	Required	Company, investor or firm name, e.g. "stripe"

Request Example

PitchBook Profile Search Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/profiles/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "15", "page": "1", "query": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "query": "string",
  "page": 0,
  "total_pages": 0,
  "results_count": 0,
  "results": [
    {
      "position": 0,
      "name": "string",
      "profile_type": "string",
      "profile_kind": "string",
      "pitchbook_id": "1234567890",
      "url": "https://example.com/...",
      "logo": "string"
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "PitchBook Profile Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
query	string	Yes	The search query that was used.
page	integer	No	Results page that was returned.
total_pages	integer	No	Number of result pages PitchBook reports for the query (15 profiles per page).
results_count	integer	Yes	Number of profiles returned in this response.
results	array<object>	Yes	Matching profiles, in PitchBook's order.
results[].position	integer	Yes	1-based rank of the profile across all result pages.
results[].name	string	Yes	Company, investor or other entity name.
results[].profile_type	string	Yes	Profile type as shown by PitchBook, e.g. Company, Investor, Limited Partner, Advisor.
results[].profile_kind	string	No	Profile type as used in the URL, e.g. company, investor, limited-partner, advisor.
results[].pitchbook_id	string	Yes	PitchBook entity ID, e.g. 54782-29.
results[].url	string	Yes	PitchBook profile URL, usable with the profile details endpoint.
results[].logo	string \| null	No	Logo image URL.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/profiles/search?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

query,limit,page
example,15,1

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/pitchbook/profiles/details

PitchBook Profile Details

POST /api/v1/pitchbook/profiles/details

Get a company, investor or fund profile from its PitchBook profile URL, including description, quick facts, website, headquarters, industries and verticals, funding rounds, investors, investments and acquisitions, exits, competitors, subsidiaries, patents, related news and FAQs.

Overview

POST /api/v1/pitchbook/profiles/details

Method: POST Path: /api/v1/pitchbook/profiles/details Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
profile_url	string	Required	Full PitchBook profile URL (e.g. https://pitchbook.com/profiles/company/54782-29).

Request Example

PitchBook Profile Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/profiles/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "url": "https://example.com/...",
  "pitchbook_id": "1234567890",
  "profile_kind": "string",
  "name": "string",
  "logo": "string",
  "description": "string",
  "overview": {},
  "website": "string",
  "social_links": {},
  "verticals": [
    "string"
  ],
  "corporate_office": [
    "string"
  ],
  "phone": "string",
  "address": {
    "street": "string",
    "city": "string",
    "region": "string",
    "postal_code": "string",
    "country": "string"
  },
  "general_information": {},
  "funding_rounds": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "competitors": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "investors": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "investments": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "affiliates": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "patents": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "exits": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "funds": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "co_investors": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "benchmark": {
    "total": 0,
    "items": [
      {
        "profile_url": "https://example.com/..."
      }
    ]
  },
  "related_news": [
    {
      "title": "string",
      "summary": "string",
      "date": "2026-01-01T12:00:00Z",
      "url": "https://example.com/...",
      "image": "string"
    }
  ],
  "related_research": [
    {
      "title": "string",
      "date": "2026-01-01T12:00:00Z",
      "url": "https://example.com/..."
    }
  ],
  "faqs": [
    {
      "question": "string",
      "answer": "string"
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "PitchBook Profile Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
url	string	Yes	Canonical PitchBook profile URL.
pitchbook_id	string	Yes	PitchBook entity ID, e.g. 54782-29.
profile_kind	string	Yes	Profile type from the URL, e.g. company, investor, limited-partner, advisor.
name	string	Yes	Entity name.
logo	string \| null	No	Logo image URL.
description	string \| null	No	Business description.
overview	object	Yes	Quick facts from the profile header, keyed by label (e.g. year_founded, status, employees, latest_deal_type, latest_deal_amount, investors, investor_type).
website	string \| null	No	Company website URL.
social_links	object	No	Social profile URLs keyed by network (linkedin, x, facebook...).
verticals	array<string>	No	Industry verticals the entity belongs to.
corporate_office	array<string>	No	Corporate office address lines.
phone	string \| null	No	Phone number, when shown publicly.
address	object \| null	No	Structured headquarters address.
address.street	string \| null	No	Street address.
address.city	string \| null	No	City.
address.region	string \| null	No	State or region.
address.postal_code	string \| null	No	Postal code.
address.country	string \| null	No	Country.
general_information	object	No	Other general information fields keyed by label (e.g. formerly_known_as, ownership_status, financing_status, primary_industry, other_industries).
funding_rounds	object	No	Valuation and funding history (deal type, date, amount, status, stage).
funding_rounds.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
funding_rounds.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
funding_rounds.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
competitors	object	No	Competitors with financing status and location.
competitors.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
competitors.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
competitors.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
investors	object	No	Investors with type and holding.
investors.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
investors.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
investors.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
investments	object	No	Investments and acquisitions made by the company, investor or fund.
investments.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
investments.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
investments.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
affiliates	object	No	Subsidiaries and other affiliates.
affiliates.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
affiliates.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
affiliates.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
patents	object	No	Recent patent activity.
patents.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
patents.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
patents.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
exits	object	No	Exits from the investor's portfolio (investor profiles).
exits.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
exits.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
exits.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
funds	object	No	Funds managed by the investor (investor profiles).
funds.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
funds.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
funds.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
co_investors	object	No	Investors that most often co-invest with this investor (investor profiles).
co_investors.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
co_investors.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
co_investors.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
benchmark	object	No	Peer funds used to benchmark this fund (fund profiles).
benchmark.total	integer	Yes	Total number of entries PitchBook lists for this section (the preview shows only some of them).
benchmark.items	array<object>	Yes	Entries shown in the profile preview. Keys follow the table's column names; values only available to subscribers are null.
benchmark.items[].profile_url	string \| null	No	PitchBook profile URL of the company or investor in this row, when linked.
related_news	array<object>	No	Recent PitchBook news articles about the entity.
related_news[].title	string	Yes	Article headline.
related_news[].summary	string \| null	No	Article summary.
related_news[].date	string \| null	No	Publication date as shown.
related_news[].url	string \| null	No	Article URL.
related_news[].image	string \| null	No	Article image URL.
related_research	array<object>	No	Related PitchBook research reports.
related_research[].title	string	Yes	Report title.
related_research[].date	string \| null	No	Release date as shown.
related_research[].url	string \| null	No	Report URL.
faqs	array<object>	No	Frequently asked questions about the entity, with answers.
faqs[].question	string	Yes	Question.
faqs[].answer	string	Yes	Answer.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/profiles/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

profile_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/pitchbook/news/latest

PitchBook Latest News

POST /api/v1/pitchbook/news/latest

Get the latest PitchBook news articles and research reports on venture capital, private equity, M&A and credit, with headlines, topics, dates, summaries and article URLs.

Overview

Get the latest PitchBook news articles and research reports on venture capital, private equity, M&A and credit, with headlines, topics, dates, summaries and article URLs.

POST /api/v1/pitchbook/news/latest

Method: POST Path: /api/v1/pitchbook/news/latest Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
limit	integer	Optional	Maximum number of articles to return (1-60).
topic	string	Optional	Optional news section, e.g. "venture-capital", "private-equity", "credit" or "artificial-intelligence". Leave empty for the main news page.

Request Example

PitchBook Latest News Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/news/latest" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "20", "topic": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "topic": "string",
  "source_url": "https://example.com/...",
  "results_count": 0,
  "results": [
    {
      "position": 0,
      "title": "string",
      "url": "https://example.com/...",
      "content_type": "string",
      "category": "string",
      "summary": "string",
      "date": "2026-01-01T12:00:00Z",
      "read_time": "string",
      "image": "string"
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "PitchBook Latest News",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
topic	string \| null	No	News section that was requested, or null for the main news page.
source_url	string	Yes	PitchBook news page the articles were listed on.
results_count	integer	Yes	Number of articles returned in this response.
results	array<object>	Yes	Articles and reports, in the order shown on the page.
results[].position	integer	Yes	1-based position on the page.
results[].title	string	Yes	Headline.
results[].url	string	Yes	Article URL, usable with the news article details endpoint.
results[].content_type	string	Yes	article or report.
results[].category	string \| null	No	Topic label shown with the article.
results[].summary	string \| null	No	Short summary, when shown.
results[].date	string \| null	No	Publication date as shown, e.g. November 5th, 2026.
results[].read_time	string \| null	No	Estimated read time, when shown.
results[].image	string \| null	No	Thumbnail image URL.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/news/latest?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

limit,topic
20,example

Pricing & Rate Limits

Endpoint Pricing

$0.0012 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Connected APIsPOST

/api/v1/pitchbook/news/details

PitchBook News Article Details

POST /api/v1/pitchbook/news/details

Get a PitchBook news article or report page from its URL, including headline, sub-headline, authors, publish date, section, tags, lead image and full article text.

Overview

Get a PitchBook news article or report page from its URL, including headline, sub-headline, authors, publish date, section, tags, lead image and full article text.

POST /api/v1/pitchbook/news/details

Method: POST Path: /api/v1/pitchbook/news/details Category: Jobs & B2B

Request Parameters

Endpoint Parameters

Name	Type	Requirement	Description
article_url	string	Required	Full PitchBook news article URL (e.g. https://pitchbook.com/news/articles/unicorn-startups-list-trends).

Request Example

PitchBook News Article Details Request Examples

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/news/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_url": "example"}'

Response Example

200 OK

Typical 200 OK JSON response structure with envelope metadata.

json

{
  "url": "https://example.com/...",
  "content_type": "string",
  "title": "string",
  "subtitle": "string",
  "description": "string",
  "authors": [
    {
      "name": "string",
      "url": "https://example.com/..."
    }
  ],
  "published_at": "2026-01-01T12:00:00Z",
  "modified_at": "2026-01-01T12:00:00Z",
  "section": "string",
  "tags": [
    "string"
  ],
  "image": "string",
  "image_alt": "string",
  "body": "string",
  "paragraphs": [
    "string"
  ],
  "word_count": 0,
  "links": [
    {
      "text": "string",
      "url": "https://example.com/..."
    }
  ],
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "PitchBook News Article Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Response Schema

Response Fields

Field	Type	Required	Description
url	string	Yes	Canonical article URL.
content_type	string	Yes	article or report.
title	string	Yes	Headline.
subtitle	string \| null	No	Sub-headline.
description	string \| null	No	Short description of the article.
authors	array<object>	Yes	Article authors.
authors[].name	string	Yes	Author name.
authors[].url	string \| null	No	Author page URL.
published_at	string \| null	No	Publication timestamp (ISO 8601).
modified_at	string \| null	No	Last update timestamp (ISO 8601).
section	string \| null	No	News section.
tags	array<string>	No	Topic tags.
image	string \| null	No	Lead image URL.
image_alt	string \| null	No	Lead image description.
body	string \| null	No	Full article text, paragraphs separated by blank lines.
paragraphs	array<string>	Yes	Article text split into paragraphs and subheadings.
word_count	integer	No	Number of words in the article body.
links	array<object>	No	Links in the article body, e.g. to PitchBook company and investor profiles.
links[].text	string	Yes	Link text.
links[].url	string	Yes	Link URL.

Asynchronous Requests

Async Workflow

curl -X POST "https://api.dataguru.cc/api/v1/pitchbook/news/details?async=true" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 202 Accepted
{
  "success": true,
  "status": "SUBMITTED",
  "job_id": "0ca215ce-244f-4b28-b481-dc1b551983c8",
  "status_url": "/api/v1/jobs/0ca215ce-244f-4b28-b481-dc1b551983c8/"
}

Batch Processing

Batch Workflow

article_url
example

Pricing & Rate Limits

Endpoint Pricing

$0.0022 / per successful request (USD)

Billing Active

Consumed per successful call: 1 request unit(s), 1 credit(s).

Endpoint Rate Limits

Per Minute60

Per Hour1,000

Per Day10,000

Monthly Quota100,000

Common Errors

Common HTTP Errors

Status	Code	Description
400	VALIDATION_ERROR	A required parameter is missing or malformed.
401	UNAUTHORIZED	Missing or invalid API key.
402	INSUFFICIENT_BALANCE	Your balance cannot cover this request.
403	ENDPOINT_DISABLED	This endpoint is currently unavailable.
405	METHOD_NOT_ALLOWED	The endpoint was called with the wrong HTTP method.
429	RATE_LIMIT_EXCEEDED	Too many requests. See the Retry-After header.
502	PROVIDER_ERROR	The upstream data source failed. Retry with exponential backoff.

Guides

Error Reference

Standard HTTP status codes and error envelopes

DataGuru uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success, 4xx indicate client error, and 5xx indicate server errors.

HTTP Status Codes & Errors

DataGuru uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided, and codes in the 5xx range indicate an error with our servers.

Standard Error Envelope

When an error occurs, the API returns a JSON envelope containing a machine-readable code and a human-readable message.

Error Response Structure

json

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please retry after 60 seconds.",
    "retry_after": 60
  }
}

Error Code Reference

Standard Error Codes

Status	Code	Description
200	OK	Everything worked as expected.
400	BAD_REQUEST	The request was unacceptable, often due to missing a required parameter.
401	UNAUTHORIZED	No valid API key provided.
402	INSUFFICIENT_BALANCE	Insufficient balance in your USD wallet to execute this endpoint.
403	FORBIDDEN	The API key doesn't have permissions to perform the request.
404	NOT_FOUND	The requested resource doesn't exist.
409	CONFLICT	The request conflicts with another request.
429	RATE_LIMITED	Too many requests hit the API too quickly.
500	INTERNAL_ERROR	Something went wrong on DataGuru's end.
503	UPSTREAM_ERROR	The target platform is down or unreachable.

Guides

Batch Processing

Upload a CSV of requests and get every result at half price

Send up to 100,000 requests to one endpoint in a single CSV upload. Rows run in the background within 24 hours (up to 7 days for large files) and each successful row costs 50% of the normal price.

Overview

Batch processing is for work that does not need an answer straight away: refreshing a product catalogue, enriching a list of profiles or running a long list of searches. You upload one CSV file where each row is one request to the same endpoint. DataGuru runs the rows in the background using spare capacity and you download all the results when the batch has finished.

At a glance

	Batch
Price	50% of the endpoint price, per successful row
Failed rows	Free
Turnaround	24 hours, plus 1 day per 10,000 rows, up to 7 days
File size	Up to 100,000 rows and 25 MB (UTF-8 CSV)
Billing mode	USD balance only
Balance needed	Enough for one row to start; funds are held 500 rows at a time
Results kept	30 days after the batch deadline

From the dashboard

You can also upload a file without writing code: open an endpoint in the Playground, choose "Upload file" and download the ready-made CSV template. Batches from the API and the Playground both appear on the Requests page.

1. Prepare the CSV file

The first row is the header and lists parameter names of the endpoint, exactly as they appear in its Request Parameters table. Every following row is one request. Columns for required parameters must be present; optional columns can be left out or left empty, in which case the parameter default is used. Array and object parameters can be written as JSON in the cell. Empty lines are ignored.

queries.csv for Target Product Search

csv

query,limit
airpods,3
lego star wars,2
stanley cup,

Every row is checked before anything is charged

If any row is invalid (a missing required value, a wrong type, an unknown column) the whole file is rejected with the line numbers of the problems, and nothing is reserved or charged. Fix the listed lines and upload the file again.

2. Submit the batch

POST the file as multipart form data in a field named "file" to the endpoint path with ?batch=true added. Uploads always use POST, even for endpoints that are called with GET. The response is 202 Accepted with a batch_id and the deadline by which every row will have run.

Submit a batch

curl -X POST "https://api.dataguru.cc/api/v1/target/products/search?batch=true" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -F "file=@queries.csv"

Or name the endpoint in a form field

curl

curl -X POST "https://api.dataguru.cc/api/v1/batches/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -F "endpoint_path=target/products/search" \
  -F "file=@queries.csv"

202 Accepted

json

{
  "success": true,
  "message": "Batch accepted: 3 rows will be processed by 2026-10-30 07:02 UTC.",
  "batch_id": "5f5acce0-371e-443e-aaf6-6785b2e3d82c",
  "status": "PROCESSING",
  "finished": false,
  "file_name": "queries.csv",
  "endpoint": {
    "id": 45,
    "name": "Target Product Search",
    "path": "target/products/search",
    "method": "POST"
  },
  "columns": [
    "query",
    "limit"
  ],
  "rows": {
    "total": 3,
    "pending": 3,
    "succeeded": 0,
    "failed": 0,
    "skipped": 0,
    "done": 0
  },
  "progress": 0.0,
  "billing": {
    "discount": 0.5,
    "row_price_usd": 0.01,
    "funded_rows": 3,
    "reserved_usd": 0.03,
    "charged_usd": 0.0,
    "unfunded_usd": 0.0
  },
  "created_at": "2026-10-29T07:02:13.237334+00:00",
  "deadline_at": "2026-10-30T07:02:13.162946+00:00",
  "paused_at": null,
  "completed_at": null,
  "status_url": "/api/v1/batches/5f5acce0-371e-443e-aaf6-6785b2e3d82c/",
  "results_url": "/api/v1/batches/5f5acce0-371e-443e-aaf6-6785b2e3d82c/results.json",
  "summary_url": "/api/v1/batches/5f5acce0-371e-443e-aaf6-6785b2e3d82c/results.csv"
}

3. Track progress

Poll the batch every few minutes. "rows" shows how many rows are pending, succeeded, failed or skipped, and "finished" becomes true once no row is pending or running; the counts and charge are final from then on. You also get a dashboard notification when a batch finishes. GET /api/v1/batches/ lists all your batches, newest first, and GET /api/v1/batches/{batch_id}/rows/ lists individual rows (add ?status=failed, succeeded or pending to filter).

Check a batch

curl

curl "https://api.dataguru.cc/api/v1/batches/5f5acce0-371e-443e-aaf6-6785b2e3d82c/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

Batch status

status	Meaning
PROCESSING	Rows are being run.
WAITING_FOR_FUNDS	Your balance ran out. The batch continues automatically after you add funds; its deadline is paused meanwhile.
COMPLETED	Every row has run. Some rows may have failed; check "rows.failed".
CANCELLED	You stopped the batch. Rows that had not started were refunded.
EXPIRED	The deadline passed before every row could run. Rows that had not started were refunded.

4. Download the results

Results are available in three formats, in the same row order as your file. You can download them while the batch is still running; rows that have not finished show status PENDING. results.json: a JSON array with one object per row, including the full response in "data". results.jsonl: the same objects, one per line (JSON Lines), easier to stream for very large batches. results.csv: your input columns plus status, error code, error message, cost and latency for each row.

Download all responses

curl

curl -o results.json \
  "https://api.dataguru.cc/api/v1/batches/5f5acce0-371e-443e-aaf6-6785b2e3d82c/results.json" \
  -H "Authorization: Api-Key YOUR_API_KEY"

results.json

json

[
  {
    "row": 1,
    "job_id": "f694ff44-ca67-4464-a3b7-cdb7ab6e3319",
    "status": "COMPLETED",
    "input": {
      "query": "airpods",
      "limit": 3
    },
    "latency_ms": 2595,
    "cost_usd": 0.01,
    "completed_at": "2026-10-29T07:02:18.512000+00:00",
    "data": {
      "...": "Same payload as a single request to the endpoint"
    }
  },
  {
    "row": 2,
    "job_id": "7c0e4b9a-51d2-4f3e-9a86-2b5d0f1e8c34",
    "status": "FAILED",
    "input": {
      "query": "zzqx",
      "limit": 2
    },
    "latency_ms": 9120,
    "cost_usd": 0.0,
    "completed_at": "2026-10-29T07:02:27.004000+00:00",
    "error": {
      "code": "PROVIDER_ERROR",
      "message": "Failed to retrieve Target search results for 'zzqx' after 3 attempts."
    }
  }
]

Billing

Each row costs half the endpoint price. Funds are held from your USD balance 500 rows at a time, in file order, so you can upload a file larger than your balance: the upload only fails with 402 if your available balance does not cover a single row. Each row that succeeds is charged its half price; each row that fails is released back to your balance. If your balance runs out before every row is paid for, the batch status becomes WAITING_FOR_FUNDS and you get a notification. Rows already running finish, nothing more starts, and the deadline is paused. Add funds and the batch continues within a minute, with the paused time added to its deadline. A batch that waits for 7 days expires. "billing.funded_rows" and "billing.unfunded_usd" show how far the batch is paid for. Rows that never run, because you stopped the batch or it expired, are refunded. For endpoints priced per record, each row holds up to 100 records and you are charged for the records actually returned, at half price.

Stop a batch

curl

# Rows that have not started are cancelled and refunded; rows already running finish normally
curl -X POST "https://api.dataguru.cc/api/v1/batches/5f5acce0-371e-443e-aaf6-6785b2e3d82c/cancel/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

Errors

Upload errors return {"success": false, "error": "...", "code": "..."}. For ROWS_INVALID, "details.row_errors" lists up to 50 problem rows with their line numbers in the file (the header is line 1), and "details.invalid_rows" gives the total.

Batch error codes

Status	Code	Description
400	FILE_REQUIRED	No file was sent in the "file" field.
400	FILE_NOT_CSV	The file is not UTF-8 encoded text.
400	FILE_EMPTY	The file has no header row or no data rows.
400	UNKNOWN_COLUMNS	A header column is not a parameter of this endpoint. "details" lists the allowed columns.
400	MISSING_COLUMNS	A required parameter has no column and no default.
400	DUPLICATE_COLUMNS	A column name appears more than once.
400	ROWS_INVALID	One or more rows failed validation. Nothing was submitted or charged.
402	BATCH_REQUIRES_USD_BILLING	Batches are only available for accounts billed in USD.
402	INSUFFICIENT_BALANCE	Your available balance does not cover even one row.
404	ENDPOINT_NOT_FOUND	The endpoint does not exist or is not active.
405	METHOD_NOT_ALLOWED	Batch uploads must use POST.
409	BATCH_NOT_ACTIVE	The batch you tried to stop has already finished or stopped.
413	FILE_TOO_LARGE	The file is larger than 25 MB.
413	TOO_MANY_ROWS	The file has more than 100,000 rows. Split it into several batches.

API Documentation

Introduction

1. Obtain Your API Key

2. Make a Request

Passing the API Key

Key Environments

Authentication Errors

Overview

Rate Limiting Overview

Understanding Headers

Rate Limit Response Headers

3. Process the Response

Authentication Error Codes

Request Parameters

Endpoint Parameters

Request Example

Response Example

200 OK

Response Schema

Response Fields

Asynchronous Requests

Batch Processing

Pricing & Rate Limits

Endpoint Pricing

Endpoint Rate Limits

Common Errors

Common HTTP Errors

Overview

Request Parameters

Endpoint Parameters

Request Example

Response Example

200 OK

Asynchronous Requests

Batch Processing

Pricing & Rate Limits

Endpoint Pricing

Endpoint Rate Limits

Common Errors

Common HTTP Errors

Overview

Request Parameters

Endpoint Parameters

Request Example

Response Example

200 OK

Asynchronous Requests

Pricing & Rate Limits

Endpoint Pricing

Endpoint Rate Limits

Common Errors

Common HTTP Errors

Interactive Test Console

Try it live

Overview

Request Parameters

Endpoint Parameters

Request Example

Response Example

200 OK

Asynchronous Requests

Pricing & Rate Limits

Endpoint Pricing

Endpoint Rate Limits

Common Errors

Common HTTP Errors

Interactive Test Console

Try it live

Overview

Request Parameters

Endpoint Parameters

Request Example

Response Example

200 OK

Response Schema

Response Fields

Asynchronous Requests

Batch Processing

Pricing & Rate Limits

Endpoint Pricing