The Socialgist Reviews allows you to search for reviews.

The complete Socialgist documentation about their endpoint can be found in their site here.

New to Datastreamer? Start here.

👍

Unify Schema

This data source already use Unify Schema.

API Key

You will need a Socialgist API key to use this component. If you don't have one reach out to [email protected] and our team will help you with that.

How to use?

The Socialgist Reviews is powered by the Jobs System, when interacting with the component you have the option to define your jobs queries.

Search Queries

Filters

Available filters can be found in the table below:

The query can be designed to specify the field to search in using the extended query syntax described here. See below some query examples.

Phrase:

"hello world"

Operator OR:

hello | world

Field:

@title hello @body world

Examples

Search for 'government'

Search for 'government' in the USA, using the English language.

Using the API, you can use the Code button to extract this example:

curl --location 'https://api.platform.datastreamer.io/api/pipelines/{PIPELINE_ID}/components/{COMPONENT_ID}/jobs?ready=true' \
      --header 'apikey: <your-api-key>' \
      --header 'Content-Type: application/json' \
      --data \
        '{
          "job_name": "{JOB_NAME}",
          "data_source": "socialgist_reviews",
          "query": {
            "query": "quality",
            "country": "US",
            "language": "en"
          },
          "job_type": "oneTime",
          "query_from": "2025-01-01T00:00:00.000Z",
          "query_to": "2025-01-07T00:00:00.000Z",
          "max_documents": 10
        }'

For more details on creating data collection jobs, see Job Management.