How to monitor energy and fuel price news#

To monitor energy and fuel news, scope /v1/news/everything with industry.id — 326 is Fuel (exploration, extraction, transport and consumer fuel products), 331 is Coal logistics, 353 is Specialty Energy (marine, ocean vessel and jet fuel). Then layer sentiment on top to read market mood, and use /v1/news/trends to see which parts of the sector are gaining attention.

curl "https://api.apitube.io/v1/news/everything?industry.id=326,331,353&sort.by=published_at&sort.order=desc&per_page=50" \
  -H "X-API-Key: YOUR_API_KEY"

Pass the key as the api_key query parameter or as an X-API-Key header. industry.id takes up to three comma-separated numeric IDs with OR logic.

Which industry IDs cover the energy sector?#

Energy is spread across several classifiers, and the description matters because the boundaries are not obvious:

• 326 — Fuel. Exploration, extraction and transport of raw fuel materials plus the consumer products made from them, including related equipment and energy generation. Explicitly excludes electric utilities.
• 331 — Coal logistics. Moving coal and its waste products by rail and sea for use as fuel.
• 353 — Specialty Energy. Non-automotive fuels: marine, ocean vessel and jet fuel.

Because electric utilities sit outside 326, a feed built only on these three IDs will cover hydrocarbons and miss grid and power-generation coverage. Resolve additional IDs from free text with /v1/suggest/industries?prefix=energy, or browse the APITube industry list. Every article returns an industries array so you can see which classifier matched. The filter’s rules are covered in how to filter news by industry.

How do you narrow to price coverage specifically?#

The sector feed carries everything from drilling permits to refinery maintenance. Add title to require price language in the headline:

curl "https://api.apitube.io/v1/news/everything?industry.id=326&title=oil%20prices&published_at.start=NOW-7DAYS" \
  -H "X-API-Key: YOUR_API_KEY"

Multiple words in title are matched with AND regardless of order, so title=oil prices requires both words somewhere in the headline. Wrap the phrase in double quotes — title="oil prices" — to require that exact order, which trims roughly a quarter of the matches in practice. Use ignore.title to strip a recurring noise term, and organization.name when you want a specific producer’s coverage regardless of headline wording.

How do you read market mood rather than volume?#

Sentiment filters split the feed by tone. sentiment.overall.polarity accepts positive, neutral or negative, and sentiment.overall.score gives you the raw value from -1 to 1 with .min and .max bounds:

curl "https://api.apitube.io/v1/news/everything?industry.id=326&sentiment.overall.polarity=negative&published_at.start=NOW-30DAYS" \
  -H "X-API-Key: YOUR_API_KEY"

Raw negative counts follow total coverage volume, so a busy news week always produces more negative articles. Track the ratio instead — call /v1/news/count once with the industry filter and once with the polarity added, over the same window, and divide. A rising negative share while total volume stays flat is the signal worth alerting on. See how to filter news by sentiment for the full parameter set.

How do you see which parts of the sector are heating up?#

/v1/news/trends aggregates a field and ranks values by article count, which turns “what is the energy sector talking about” into one request. The field parameter accepts source.id, category.id, topic.id, industry.id and entity.id — other field names are rejected with an HTTP 400:

curl "https://api.apitube.io/v1/news/trends?field=industry.id&industry.id=326,331,353&per_page=10&trending=true" \
  -H "X-API-Key: YOUR_API_KEY"

With trending=true each result carries a trending_score — the ratio of recent to historical activity, where above 1 means rising and below 1 means declining — plus trending_history and growth_rate. Adding compare=true with compare_window=7DAYS returns previous_count, change_absolute and change_percent against the prior period, and unlocks sorting by change or trending_score. Every standard news filter narrows the set before aggregation, so the trends call above ranks only within the energy industries. More detail in how to discover trending topics and entities.

How do you compare energy coverage across markets?#

source.country.code scopes to where the outlet is based, which works well for national energy press and regulators:

curl "https://api.apitube.io/v1/news/count?industry.id=326&source.country.code=us&published_at.start=NOW-30DAYS" \
  -H "X-API-Key: YOUR_API_KEY"

For a full geographic breakdown in one call rather than one request per country, use faceting: facet=true&facet.field=source.country.id returns counts across the entire match set. Pair it with per_page=1 so you pay for the aggregation and not for article payloads. This same combination underpins the sector dashboards described in how to build market intelligence from news.

Common Questions#

• Does industry.id=326 include electricity and utilities?
• Can I get commodity prices from the API?
• Which fields can I use with /v1/news/trends?
• How do I track a single producer rather than the whole sector?

Does industry.id=326 include electricity and utilities?#

No. The Fuel classifier covers exploration, extraction and transport of raw fuel materials, the consumer products derived from them, and related equipment and energy generation — but its definition explicitly excludes electric utilities. A feed built on 326, 331 and 353 is a hydrocarbons feed. If your coverage needs to include grid operators and power retailers, resolve their industry IDs separately with /v1/suggest/industries and run a second request, since industry.id caps at three values per call.

Can I get commodity prices from the API?#

No. APITube indexes news coverage, not market data — there is no price field, no ticker and no time series of quotes. What you get is the reporting around prices: how much is being written, by whom, in what tone, and which parts of the sector are gaining attention. That is useful as a sentiment or attention overlay on top of a real price feed, and it is what the sentiment and trends filters above are for. Quoted figures appear inside the article body only when the reporter wrote them.

Which fields can I use with /v1/news/trends?#

Exactly five: source.id, category.id, topic.id, industry.id and entity.id. Up to five can be combined in one comma-separated field value. Anything else — including attribute-style names that work as ordinary filters — is rejected with an HTTP 400 and an explicit list of the allowed fields in the error message. All the normal news filters still apply to a trends call and narrow the set before aggregation.

How do I track a single producer rather than the whole sector?#

Use organization.name to match the company entity anywhere in the article, or title to require its name in the headline when you want only stories genuinely about that producer. Combine either with the industry filter to drop coverage that mentions the company in an unrelated context. For a comparable scoreboard across several producers, loop the same request over your watchlist against /v1/news/count with a fixed time window — one small request each, no article payloads — then fetch articles only for the names whose volume moved.