Get Started

Socialgist Blogs

The Blogs search allows you to search for blog posts and/or comments.

The Socialgist Blogs search allows you to search for blog posts and/or comments.

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 Blogs 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 for Socialgist Blogs can be found in the table below:

Filter NameDescription
queryString to search
countryFilter results by the source country. Multiple countries are allowed.
languageFilter results by the language. Multiple languages are allowed.
domainDomain name used to filter search results. Multiple domain values can be submitted separated by commas.
site_keyExternal ID of the site to search in
max_documentsSet a limit for the number of posts that will be fetched for the search.

The query can be used 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, on 'cnn.com'.

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_blogs",
          "query": {
            "query": "government",
            "country": "US",
            "language": "en",
            "domain": "cnn.com"
          },
          "job_type": "oneTime",
          "query_from": "2025-01-01T00:00:00.000Z",
          "query_to": "2025-01-06T00:00:00.000Z",
          "max_documents": 10
        }'

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