Search Data Apps

curl --request GET \
  --url https://api.example.com/v1/data-apps

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/data-apps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/data-apps"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/data-apps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "items": [
    {}
  ],
  "pagination": {
    "offset": 123,
    "limit": 123,
    "count": 123,
    "total": 123,
    "has_more": true
  },
  "low_confidence": true
}

GET

data-apps

Search Data Apps

curl --request GET \
  --url https://api.example.com/v1/data-apps

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/data-apps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/data-apps"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/data-apps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "items": [
    {}
  ],
  "pagination": {
    "offset": 123,
    "limit": 123,
    "count": 123,
    "total": 123,
    "has_more": true
  },
  "low_confidence": true
}

GET https://api-datahub.octoparse.com/v1/data-apps Authentication: optional. Anonymous access works; with an API key you unlock logged-in filters and more content. Market search. Anonymous access is allowed. With an empty q, results are ordered by latest publish time. With a non-empty q, results are ordered by relevance. With an API key you get two extensions:

View switch: owner=me lists apps you published (including unpublished drafts; cards include status and scope). shared_with=me lists apps shared with you point-to-point.
Visibility scope: without a view switch, scope controls the candidate set. Default or public is the market; private is your private apps; shared is every share-visible app (shared by you and shared with you); all is everything visible to the current credential, and anonymously it naturally degrades to the market. In attribute mode, status defaults to published apps only.

Cards carry only what you need for selection: name, summary, capability boundary, input/output hints, execution mode, starting price, and price table. Full input/output contracts, execution profile, and call samples come from App detail.

Request

Query parameters

string

Business keywords in any language. Add a platform name to narrow the range (for example temu reviews). Empty lists the catalog.

string

Filter by app type. data fetches external data; transform processes existing data.Values: data / transform.

string

Filter by capability. data-acquisition acquires data; data-processing processes data.Values: data-acquisition / data-processing.

string

Pass me to switch to the “apps I published” view. Requires an API key.

string

Pass me to switch to the “apps shared with me” view. Requires an API key.

string

Visibility scope. public is the market (default), private is your private apps, shared is apps inside a share relationship, all is the full visible set. The last three require an API key.Values: public / private / shared / all.

string

Filter by lifecycle status. draft, published, or deprecated. Attribute mode defaults to published.Values: draft / published / deprecated.

integer

default:"0"

Pagination offset.Range ≥ 0.

integer

default:"5"

Page size.Range 1 to 100.

Example request

curl \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  "https://api-datahub.octoparse.com/v1/data-apps?q=reviews&limit=5"

Response

200 success

{
  "data": {
    "items": [
      {
        "app_id": "app_6dfe4e839ccf",
        "namespace": "carol",
        "app_name": "probe-b",
        "name": "Product review lookup",
        "type": "data",
        "summary": "Fetch a review list by product id",
        "capability": "data-acquisition",
        "keywords": [
          "reviews",
          "ecommerce"
        ],
        "boundary": "Public reviews only; buyer-show images are not included",
        "required_input_hint": [
          "product"
        ],
        "main_output_hint": [
          "review_id",
          "content",
          "rating"
        ],
        "execution_mode": "sync",
        "price_from": 0.001,
        "pricing": {
          "events": [
            {
              "event": "record",
              "label": "One record",
              "unit_price": 0.001,
              "qty_from": "",
              "unit_size": null
            }
          ]
        },
        "match_score": 1.0,
        "published_at": "2026-09-15T07:45:38.633930+00:00",
        "updated_at": "2026-09-15T07:45:38.633930+00:00",
        "source_locale": "en-US"
      }
    ],
    "pagination": {
      "offset": 0,
      "limit": 5,
      "count": 1,
      "total": 1,
      "has_more": false
    },
    "low_confidence": false
  }
}

The payload is wrapped in data. Fields:

object[]

required

Card list.

object

required

Pagination object.

Show fields

integer

—

integer

—

integer

—

integer

—

boolean

—

boolean

true when there are not enough strong matches and the returned set is weak.

Errors

HTTP	`code`	`category`	Description
401	`unauthorized`	`forbidden`	Missing or invalid API key.

Error responses use {"error": {code, category, message, retryable}}. See Errors.

Client libraries

result = client.search("reviews", limit=5)
for card in result["items"]:
    print(card["app_id"], card["namespace"], card["app_name"], card["price_from"])

# Apps shared with me
shared = client.search("", shared_with="me")

const result = await client.search("reviews", { limit: 5 });
for (const card of result.items) {
  console.log(card.app_id, card.namespace, card.app_name, card.price_from);
}

// Apps shared with me
const shared = await client.search("", { sharedWith: "me" });

GET STARTED

QUICK START

REFERENCE

DATA HUB API

Search Data Apps

Request

Query parameters

Example request

Response

200 success

Errors

Client libraries

​Request

​Query parameters

​Example request

​Response

​200 success

​Errors

​Client libraries

Request

Query parameters

Example request

Response

200 success

Errors

Client libraries