Api Endpoint

Particle Pro

Get episode timeseries. Returns time-bucketed counts of episodes matching the same filters as GET /v1/podcasts/episodes, plus range totals.

Open interactive test console

Offering

Provider
api.particle.pro
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Api
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.particle.pro/v1/podcasts/episodes/timeseries
MIME type
application/json
First seen
2026-10-16T03:04:46.000Z
Last seen
Tags
podcast episodes, podcasts, media intelligence, particle pro

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0x59f3a6dcb6f482c53872dd8f8f9e1f9161a1c5f7"
  }
]

Observed health

Status
Healthy
Latest latency
84 ms
Average latency
171 ms
HTTP status
402
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "method": {
      "enum": [
        "GET"
      ],
      "type": "string"
    },
    "queryParams": {
      "properties": {
        "company_id": {
          "description": "Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.",
          "type": "string"
        },
        "entity_id": {
          "description": "Entity or person slug (e.g., 'elon-musk', 'openai') or ID. Counts episodes featuring this entity as a speaker or mentioned entity. A person with no linked entity counts the episodes they speak in. A slug that names both an entity and a person means the entity; pass the person's ID to count the person.",
          "type": "string"
        },
        "fully_ingested": {
          "description": "Only count episodes that have reached the terminal ingestion milestone",
          "type": "boolean"
        },
        "guest_capacity": {
          "description": "Only episodes with a guest who knows their field in this capacity, such as executive_founder for founders. It narrows the other filters; an everyday word for a capacity passed as guest_occupation (founders, politicians) lands here too.",
          "enum": [
            "researcher",
            "licensed_professional",
            "practitioner",
            "executive_founder",
            "public_official",
            "journalist_analyst",
            "creator_entertainer",
            "athlete_coach",
            "clergy",
            "firsthand",
            "layperson"
          ],
          "type": "string"
        },
        "guest_field": {
          "description": "Only episodes with a guest listed under this ANZSRC 2020 field of research (code, slug, or title).",
          "type": "string"
        },
        "guest_in_field": {
          "description": "Only episodes with a guest speaking within their field (the guest the other guest_ filters select, when given).",
          "type": "boolean"
        },
        "guest_occupation": {
          "description": "Only episodes with a guest listed under this SOC 2018 or ISCO-08 occupation (code, slug, or title), including a SOC group or everyday name such as physicians or doctors. A word with no occupation filters by the field of research or capacity it names: oncologists is field 3211, founders is guest_capacity=executive_founder.",
          "type": "string"
        },
        "guest_practicing": {
          "description": "Only episodes with a guest who still works in guest_occupation, a SOC 2018 occupation or group.",
          "type": "boolean"
        },
        "guest_seniority": {
          "description": "Only episodes with a guest at this seniority or above.",
          "enum": [
            "professional",
            "senior",
            "distinguished"
          ],
          "type": "string"
        },
        "guest_standing": {
          "description": "Only episodes with a guest whose standing is recognized this way.",
          "enum": [
            "established",
            "self_described",
            "unverified"
          ],
          "type": "string"
        },
        "has_transcript": {
          "description": "Only count episodes with completed transcripts",
          "type": "boolean"
        },
        "interval": {
          "description": "Bucket width. Weeks start on Monday and all buckets are UTC-aligned.",
          "enum": [
            "day",
            "week",
            "month"
          ],
          "type": "string"
        },
        "keyword_search": {
          "description": "Keyword filter over episode transcript content. Double-quoted substrings must appear as exact phrases; unquoted terms must all appear in a transcript segment. Counts episodes with at least one matching segment and adds mention_count fields to the response. Combines with the other filters, but not with semantic_search.",
          "type": "string"
        },
        "language": {
          "description": "Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'.",
          "type": "string"
        },
        "max_duration": {
          "description": "Maximum episode duration in seconds",
          "format": "int64",
          "type": "integer"
        },
        "min_duration": {
          "description": "Minimum episode duration in seconds",
          "format": "int64",
          "type": "integer"
        },
        "person_id": {
          "description": "Person slug (e.g., 'dick-costolo'), knowledge-graph entity slug for the same person, or ID. Counts episodes featuring this person as a speaker. Works even when the speaker has no knowledge-graph entity linked. When the value itself matches a knowledge-graph entity slug (corroborated to the same person), the default and 'mention' roles also count episodes that merely mention the person, matching entity_id semantics; pass a speaker role (guest, host, panelist, correspondent) for speaker-only counts.",
          "type": "string"
        },
        "podcast_id": {
          "description": "Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID",
          "type": "string"
        },
        "published_after": {
          "description": "Deprecated alias of since.",
          "type": "string"
        },
        "published_before": {
          "description": "Deprecated alias of until.",
          "type": "string"
        },
        "role": {
          "description": "Entity role filter. Constrains which episodes match the entity_id, person_id, or company_id. 'speaker' matches any speaking role (host, co-host, guest, panelist, correspondent) without including mention-only episodes.",
          "enum": [
            "guest",
            "host",
            "panelist",
            "correspondent",
            "speaker",
            "mention"
          ],
          "type": "string"
        },
        "semantic_search": {
          "description": "Vector-similarity filter by meaning over episode transcript content — the counting twin of the search endpoint's semantic_search, using the same similarity threshold. Express the query the way you'd describe the topic to a colleague; paraphrase tolerant. Counts episodes with at least one semantically matching segment and adds mention_count fields to the response; for pathologically broad queries the mention counts can be lower bounds. Requires since (ranges up to ~2 years). Combines with the other filters, but not with keyword_search.",
          "type": "string"
        },
        "since": {
          "description": "Inclusive start of the range as an ISO 8601 date or date-time. Omit for all time.",
          "type": "string"
        },
        "until": {
          "description": "End of the range as an ISO 8601 date or date-time. A bare date includes that whole day. Defaults to now.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "company_id": {
              "description": "Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.",
              "type": "string"
            },
            "entity_id": {
              "description": "Entity or person slug (e.g., 'elon-musk', 'openai') or ID. Counts episodes featuring this entity as a speaker or mentioned entity. A person with no linked entity counts the episodes they speak in. A slug that names both an entity and a person means the entity; pass the person's ID to count the person.",
              "type": "string"
            },
            "fully_ingested": {
              "description": "Only count episodes that have reached the terminal ingestion milestone",
              "type": "boolean"
            },
            "guest_capacity": {
              "description": "Only episodes with a guest who knows their field in this capacity, such as executive_founder for founders. It narrows the other filters; an everyday word for a capacity passed as guest_occupation (founders, politicians) lands here too.",
              "enum": [
                "researcher",
                "licensed_professional",
                "practitioner",
                "executive_founder",
                "public_official",
                "journalist_analyst",
                "creator_entertainer",
                "athlete_coach",
                "clergy",
                "firsthand",
                "layperson"
              ],
              "type": "string"
            },
            "guest_field": {
              "description": "Only episodes with a guest listed under this ANZSRC 2020 field of research (code, slug, or title).",
              "type": "string"
            },
            "guest_in_field": {
              "description": "Only episodes with a guest speaking within their field (the guest the other guest_ filters select, when given).",
              "type": "boolean"
            },
            "guest_occupation": {
              "description": "Only episodes with a guest listed under this SOC 2018 or ISCO-08 occupation (code, slug, or title), including a SOC group or everyday name such as physicians or doctors. A word with no occupation filters by the field of research or capacity it names: oncologists is field 3211, founders is guest_capacity=executive_founder.",
              "type": "string"
            },
            "guest_practicing": {
              "description": "Only episodes with a guest who still works in guest_occupation, a SOC 2018 occupation or group.",
              "type": "boolean"
            },
            "guest_seniority": {
              "description": "Only episodes with a guest at this seniority or above.",
              "enum": [
                "professional",
                "senior",
                "distinguished"
              ],
              "type": "string"
            },
            "guest_standing": {
              "description": "Only episodes with a guest whose standing is recognized this way.",
              "enum": [
                "established",
                "self_described",
                "unverified"
              ],
              "type": "string"
            },
            "has_transcript": {
              "description": "Only count episodes with completed transcripts",
              "type": "boolean"
            },
            "interval": {
              "description": "Bucket width. Weeks start on Monday and all buckets are UTC-aligned.",
              "enum": [
                "day",
                "week",
                "month"
              ],
              "type": "string"
            },
            "keyword_search": {
              "description": "Keyword filter over episode transcript content. Double-quoted substrings must appear as exact phrases; unquoted terms must all appear in a transcript segment. Counts episodes with at least one matching segment and adds mention_count fields to the response. Combines with the other filters, but not with semantic_search.",
              "type": "string"
            },
            "language": {
              "description": "Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'.",
              "type": "string"
            },
            "max_duration": {
              "description": "Maximum episode duration in seconds",
              "format": "int64",
              "type": "integer"
            },
            "min_duration": {
              "description": "Minimum episode duration in seconds",
              "format": "int64",
              "type": "integer"
            },
            "person_id": {
              "description": "Person slug (e.g., 'dick-costolo'), knowledge-graph entity slug for the same person, or ID. Counts episodes featuring this person as a speaker. Works even when the speaker has no knowledge-graph entity linked. When the value itself matches a knowledge-graph entity slug (corroborated to the same person), the default and 'mention' roles also count episodes that merely mention the person, matching entity_id semantics; pass a speaker role (guest, host, panelist, correspondent) for speaker-only counts.",
              "type": "string"
            },
            "podcast_id": {
              "description": "Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID",
              "type": "string"
            },
            "published_after": {
              "description": "Deprecated alias of since.",
              "type": "string"
            },
            "published_before": {
              "description": "Deprecated alias of until.",
              "type": "string"
            },
            "role": {
              "description": "Entity role filter. Constrains which episodes match the entity_id, person_id, or company_id. 'speaker' matches any speaking role (host, co-host, guest, panelist, correspondent) without including mention-only episodes.",
              "enum": [
                "guest",
                "host",
                "panelist",
                "correspondent",
                "speaker",
                "mention"
              ],
              "type": "string"
            },
            "semantic_search": {
              "description": "Vector-similarity filter by meaning over episode transcript content — the counting twin of the search endpoint's semantic_search, using the same similarity threshold. Express the query the way you'd describe the topic to a colleague; paraphrase tolerant. Counts episodes with at least one semantically matching segment and adds mention_count fields to the response; for pathologically broad queries the mention counts can be lower bounds. Requires since (ranges up to ~2 years). Combines with the other filters, but not with keyword_search.",
              "type": "string"
            },
            "since": {
              "description": "Inclusive start of the range as an ISO 8601 date or date-time. Omit for all time.",
              "type": "string"
            },
            "until": {
              "description": "End of the range as an ISO 8601 date or date-time. A bare date includes that whole day. Defaults to now.",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}