X Inspiration Posts API - Country, Period & Engagement Rank

Choose required country, period and type to request a creator-inspiration post selection. Documented country options include ALL and listed three-letter codes; periods are Daily, Weekly and Monthly, and type values are Likes or Replies. Send one value per selector, never the catalog's comma-separated choice list. This endpoint has not been live-verified: accepted-selector behavior, returned post keys and ranking semantics require validation. Use results as source-linked creative research, not universal content-performance benchmarks or permission to reuse assets.

API Features

Documented country-code choices country offers ALL and the documented three-letter selections for this inspiration endpoint, not an inferred shared country format.

Daily-to-monthly inspiration windows period offers Daily, Weekly or Monthly as separate request values; their precise collection boundaries are unverified.

Likes-versus-Replies selector type selects one of the documented engagement-oriented rankings, enabling separately captured inspiration samples.

Attribution-first creative references Retain source links from validated results and assess reuse rights independently rather than treating returned content as licensed assets.

Live API Demo

GET /api/project/twitter/inspiration-posts

Country *

Period *

Type *

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/twitter/inspiration-posts?key=<API_KEY>&country=ALL&period=Daily&type=Likes'

curl -X GET 'https://api.opendata-api.com/api/project/twitter/inspiration-posts?key=<API_KEY>&country=ALL&period=Daily&type=Likes'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Create a country-specific creative-research collection from validated selector combinations with source attribution.
Compare posts returned for Likes and Replies within the same country and period to explore response-pattern differences.
Prepare a human-reviewed inspiration shortlist for a campaign without copying assets or assuming reuse rights.
Compare available daily and weekly inspiration samples while labeling unverified ranking boundaries.

Frequently asked questions

What selectors are required for inspiration posts?

Choose one documented value each for country, period and type. Country choices include ALL and listed three-letter codes; periods are Daily, Weekly or Monthly, and types are Likes or Replies. Do not send a comma-separated list of choices.

Can I use the results as universal performance benchmarks?

No ranking semantics, precise period boundaries or response fields have been live-verified. Use validated results as attributed creative references, not universal benchmarks or permission to copy and reuse assets.

Related operations

Guides

View Subscription Plans →

Get Country and Period Inspiration Posts